Marketing API
Версия API Graph

Business

Represent a specific business on Facebook. Make the API call to the business ID.

To find the ID of a business, go to Business Manager > Business Settings > Business Info. There, you will see information about the business, including the ID.

Чтение

Represents a business on Facebook. Includes any specified properties and assets belonging to the business.

С 14 сентября 2021 года в следующих полях будут появляться ошибки для вызовов версии 12.0 и более поздних, выполненных приложениями, у которых отсутствуют необходимые разрешения конечной точки. Для всех версий это изменение вступит в силу 13 декабря 2021 г.

  • collaborative_ads_managed_partner_business_info

Пример

Graph API Explorer
GET /v21.0/{business-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{business-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{business-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{business-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{business-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Чтобы узнать, как использовать API Graph, ознакомьтесь с нашим руководством по API Graph.

Параметры

Эта конечная точка не содержит параметров.

Поля

ПолеОписание
id
numeric string

The business account ID.

По умолчанию
block_offline_analytics
bool

Specifies whether offline analytics for business is blocked.

collaborative_ads_managed_partner_business_info
ManagedPartnerBusiness

collaborative_ads_managed_partner_business_info

collaborative_ads_managed_partner_eligibility
BusinessManagedPartnerEligibility

collaborative_ads_managed_partner_eligibility

created_by
BusinessUser|SystemUser

The creator of this business.

created_time
datetime

The creation time of this business.

extended_updated_time
datetime

The update time of the extended credits for this business.

is_hidden
bool

If true, indicates the business is hidden.

link
string

URI for business profile page.

name
string

The name of the business.

По умолчанию
payment_account_id
numeric string

The ID for the payment account of this business.

primary_page
Page

The primary Facebook Page for this business.

profile_picture_uri
string

The profile picture URI of the business.

timezone_id
unsigned int32

This business's timezone.

two_factor_type
enum

The two factor type authentication used for this business.

updated_by
BusinessUser|SystemUser

The person's name who last updated this business.

updated_time
datetime

The time when this business was last updated.

verification_status
enum {expired, failed, ineligible, not_verified, pending, pending_need_more_info, pending_submission, rejected, revoked, verified}

Verification status for this business.

vertical
string

The vertical industry that this business associates with, or belongs to.

vertical_id
unsigned int32

The ID for the vertical industry.

Границы контекста

Граница контекстаОписание
ad_studies
Edge<AdStudy>

The studies this business has access to, such as any advertising lift studies or split testing studies.

adnetworkanalytics_results
Edge<AdNetworkAnalyticsAsyncQueryResult>

Obtain the results of an asynchronous Audience Network query for this publisher entity.

ads_reporting_mmm_reports
Edge<AdsReportBuilderMMMReport>

Marketing mix modeling (MMM) reports generated for this business

ads_reporting_mmm_schedulers
Edge<AdsReportBuilderMMMReportScheduler>

Marketing mix modeling (MMM) reports schedulers for this business

adspixels
Edge<AdsPixel>

The business has access to these pixels.

agencies
Edge<Business>

Agencies associated with this business.

an_placements
Edge<AdPlacement>

Placements used by this Audience Network business.

business_asset_groups
Edge<BusinessAssetGroup>

Business asset groups owned by this business. The business can grant permissions to assets in this group.

business_invoices
Edge<OmegaCustomerTrx>

The extended credit invoices of this business.

business_users
Edge<BusinessUser>

Business users associated with this business. Includes employees and admins at the business.

client_apps
Edge<Application>

This business has access to these client apps.

client_offsite_signal_container_business_objects
Edge<OffsiteSignalContainerBusinessObject>

The business has access to these client offsite signal container business objects

client_pages
Edge<Page>

This business has access to these client pages.

client_pixels
Edge<AdsPixel>

This business has access to these client pixels.

client_product_catalogs
Edge<ProductCatalog>

This business has access to these client product catalogs.

client_whatsapp_business_accounts
Edge<WhatsAppBusinessAccount>

WhatsApp business accounts that were shared to this business.

clients
Edge<Business>

Clients of this business.

collaborative_ads_collaboration_requests
Edge<CPASCollaborationRequest>

All Collaborative Ads. collaboration requests initiated by the business.

collaborative_ads_suggested_partners
Edge<CPASAdvertiserPartnershipRecommendation>

Collaborative Ads suggested partners for a business.

commerce_merchant_settings
Edge<CommerceMerchantSettings>

Commerce Merchant Settings belonging to this business.

event_source_groups
Edge<EventSourceGroup>

The business owns these event source groups. Includes various signals sources such as pixels.

extendedcredits
Edge<ExtendedCredit>

Extended credits for this business.

initiated_audience_sharing_requests
Edge<BusinessAssetSharingAgreement>

The audience sharing requests initiated by this business.

instagram_accounts
Edge<InstagramUser>

This business has access to these Instagram accounts.

openbridge_configurations
Edge<OpenBridgeConfiguration>

Get all the openbridge configurations associated to this business

owned_apps
Edge<Application>

This business owns these apps.

owned_businesses
Edge<Business>

This business aggregates and manages these client businesses.

owned_instagram_accounts
Edge<InstagramUser>

This business owns these Instagram accounts.

owned_offsite_signal_container_business_objects
Edge<OffsiteSignalContainerBusinessObject>

owned_offsite_signal_container_business_objects

owned_pages
Edge<Page>

This business owns these pages.

owned_pixels
Edge<AdsPixel>

This business owns these pixels.

owned_product_catalogs
Edge<ProductCatalog>

This business owns these product catalogs.

owned_whatsapp_business_accounts
Edge<WhatsAppBusinessAccount>

This business owns these WhatsApp Business Accounts.

pending_client_ad_accounts
Edge<BusinessAdAccountRequest>

This business requested access to these client ad accounts and is pending approval.

pending_client_apps
Edge<BusinessApplicationRequest>

This business requested access to these client apps and is pending approval.

pending_client_pages
Edge<BusinessPageRequest>

This business requested access to these client pages and is pending approval.

pending_owned_ad_accounts
Edge<BusinessAdAccountRequest>

This business requested ownership of these ad accounts and is pending approval.

pending_owned_pages
Edge<BusinessPageRequest>

This business requested ownership of these pages and is pending approval.

pending_shared_offsite_signal_container_business_objects
Edge<OffsiteSignalContainerBusinessObject>

This business received sharing requests for these offsite signal container business objects and is pending for approval.

pending_users
Edge<BusinessRoleRequest>

Admin for this business invited this user to the business. Pending user approval.

preverified_numbers
Edge<WhatsAppBusinessPreVerifiedPhoneNumber>

Edge to get list of all pre-created phone numbers for this business

received_audience_sharing_requests
Edge<BusinessAssetSharingAgreement>

The audience sharing requests received by this business.

reseller_guidances
Edge<ResellerGuidance>

Guidance for a China reseller business.

self_certified_whatsapp_business_submissions
Edge<WhatsAppBusinessPartnerClientVerificationSubmission>

Business Service Providers can submit their client information for verification on WhatsApp Business Platform. This endpoint returns statuses, submitted info, and rejection reasons for the submissions.

system_users
Edge<SystemUser>

The business's system users.

Error Codes

ОшибкаОписание
104Incorrect signature
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
368The action attempted has been deemed abusive or is otherwise disallowed
80004There have been too many calls to this ad-account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting#ads-management.
2500Error parsing graph query
459The session is invalid because the user has been checkpointed

Создание

To create other Business Managers, your business needs to obtain BUSINESS_MANAGEMENT during the app review process. If your app is in development mode, you can surpass this requirement, but to create only two child businesses.

Вы можете сделать запрос POST к границе china_business_onboarding_attributions из этих местоположений:
При размещении публикации на этой границе создается a Business.

Параметры

Эта конечная точка не содержит параметров.

Тип возврата

Struct {
id: numeric string,
link_with_id: string,
}

Error Codes

ОшибкаОписание
200Permissions error
Вы можете сделать запрос POST к границе businesses из этих местоположений:
При размещении публикации на этой границе создается a Business.

Параметры

ПараметрОписание
child_business_external_id
string

child_business_external_id

email
string

The business email of the business admin

name
string

Username

Обязательно
primary_page
numeric string

Primary Page ID

sales_rep_email
string

Sales Rep email address

survey_business_type
enum {AGENCY, ADVERTISER, APP_DEVELOPER, PUBLISHER}

Business Type

survey_num_assets
int64

Number of Assets in the business

survey_num_people
int64

Number of People that will work on the business

timezone_id
enum {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480}

Timezone ID

vertical
enum {NOT_SET, ADVERTISING, AUTOMOTIVE, CONSUMER_PACKAGED_GOODS, ECOMMERCE, EDUCATION, ENERGY_AND_UTILITIES, ENTERTAINMENT_AND_MEDIA, FINANCIAL_SERVICES, GAMING, GOVERNMENT_AND_POLITICS, MARKETING, ORGANIZATIONS_AND_ASSOCIATIONS, PROFESSIONAL_SERVICES, RETAIL, TECHNOLOGY, TELECOM, TRAVEL, NON_PROFIT, RESTAURANT, HEALTH, LUXURY, OTHER}

Vertical ID

Обязательно

Тип возврата

Эта конечная точка поддерживаетчтение после записи и будет считывать узел, представленный id в типе возврата.
Struct {
id: numeric string,
name: string,
}

Error Codes

ОшибкаОписание
100Invalid parameter
3912There was a technical issue and the changes you made to your Business Manager weren't saved. Please try again.
368The action attempted has been deemed abusive or is otherwise disallowed
3992Your payment account is disabled.
3974The name you chose for this Business Manager is not valid. Try a different name.
3918The Facebook Page you've tried to add is already owned by another Business Manager. You can still request access to this Page, but your request will need to be approved by the Business Manager that owns it.
200Permissions error
3973The name you chose for this Business Manager is not valid. Please choose another.
3947You are trying to create a Business Manager with the same name as one you are already a part of. Please pick a different name.
Вы можете сделать запрос POST к границе owned_businesses из этих местоположений:
При размещении публикации на этой границе создается a Business.

Параметры

ПараметрОписание
name
string

name

Обязательно
page_permitted_tasks
array<enum {MANAGE, CREATE_CONTENT, MODERATE, MESSAGING, ADVERTISE, ANALYZE, MODERATE_COMMUNITY, MANAGE_JOBS, PAGES_MESSAGING, PAGES_MESSAGING_SUBSCRIPTIONS, READ_PAGE_MAILBOXES, VIEW_MONETIZATION_INSIGHTS, MANAGE_LEADS, PROFILE_PLUS_FULL_CONTROL, PROFILE_PLUS_MANAGE, PROFILE_PLUS_FACEBOOK_ACCESS, PROFILE_PLUS_CREATE_CONTENT, PROFILE_PLUS_MODERATE, PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY, PROFILE_PLUS_MESSAGING, PROFILE_PLUS_ADVERTISE, PROFILE_PLUS_ANALYZE, PROFILE_PLUS_REVENUE, PROFILE_PLUS_MANAGE_LEADS, CASHIER_ROLE}>

page_permitted_tasks

sales_rep_email
string

sales_rep_email

shared_page_id
numeric string

shared_page_id

should_generate_name
boolean

should_generate_name This parameter allows the automatic creation of a Child Business Manager when set to true, using a cleaned version of the name provided in the required name parameter. If this option is used, the updated name will be returned as part of the API response.

survey_business_type
enum {AGENCY, ADVERTISER, APP_DEVELOPER, PUBLISHER}

survey_business_type

survey_num_assets
int64

survey_num_assets

survey_num_people
int64

survey_num_people

timezone_id
enum {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480}

timezone_id

vertical
enum {NOT_SET, ADVERTISING, AUTOMOTIVE, CONSUMER_PACKAGED_GOODS, ECOMMERCE, EDUCATION, ENERGY_AND_UTILITIES, ENTERTAINMENT_AND_MEDIA, FINANCIAL_SERVICES, GAMING, GOVERNMENT_AND_POLITICS, MARKETING, ORGANIZATIONS_AND_ASSOCIATIONS, PROFESSIONAL_SERVICES, RETAIL, TECHNOLOGY, TELECOM, TRAVEL, NON_PROFIT, RESTAURANT, HEALTH, LUXURY, OTHER}

vertical

Обязательно

Тип возврата

Эта конечная точка поддерживаетчтение после записи и будет считывать узел, представленный id в типе возврата.
Struct {
id: numeric string,
name: string,
}

Error Codes

ОшибкаОписание
3913It doesn't look like you have permission to create a new Business Manager.
100Invalid parameter
368The action attempted has been deemed abusive or is otherwise disallowed
200Permissions error
3974The name you chose for this Business Manager is not valid. Try a different name.
190Invalid OAuth 2.0 Access Token
3947You are trying to create a Business Manager with the same name as one you are already a part of. Please pick a different name.

Обновление

Чтобы обновить a Business, отправьте запрос POST на адрес /{business_id}.

Параметры

ПараметрОписание
entry_point
string

entry point of claiming BusinessClaimAssetEntryPoint

name
string

Business's name

primary_page
numeric string or integer

Primary page of this business

timezone_id
int64

Timezone id of this business

two_factor_type
enum{none, admin_required, all_required}

Two-factor type of the business

vertical
enum {NOT_SET, ADVERTISING, AUTOMOTIVE, CONSUMER_PACKAGED_GOODS, ECOMMERCE, EDUCATION, ENERGY_AND_UTILITIES, ENTERTAINMENT_AND_MEDIA, FINANCIAL_SERVICES, GAMING, GOVERNMENT_AND_POLITICS, MARKETING, ORGANIZATIONS_AND_ASSOCIATIONS, PROFESSIONAL_SERVICES, RETAIL, TECHNOLOGY, TELECOM, TRAVEL, NON_PROFIT, RESTAURANT, HEALTH, LUXURY, OTHER}

Vertical type of the business

Тип возврата

Эта конечная точка поддерживаетчтение после записи и будет считывать узел, представленный id в типе возврата.
Struct {
id: numeric string,
}

Error Codes

ОшибкаОписание
3974The name you chose for this Business Manager is not valid. Try a different name.
3910You need permission to edit the details of your Business Manager. Please talk to one of your Business Manager admins about changing your role or editing the Business Manager details.
3911You need permission to set up a new Business Manager.
3918The Facebook Page you've tried to add is already owned by another Business Manager. You can still request access to this Page, but your request will need to be approved by the Business Manager that owns it.
368The action attempted has been deemed abusive or is otherwise disallowed
100Invalid parameter
3947You are trying to create a Business Manager with the same name as one you are already a part of. Please pick a different name.
3912There was a technical issue and the changes you made to your Business Manager weren't saved. Please try again.
3973The name you chose for this Business Manager is not valid. Please choose another.
190Invalid OAuth 2.0 Access Token
Чтобы обновить a Business, отправьте запрос POST на адрес /{business_id}/managed_businesses.

Параметры

ПараметрОписание
child_business_external_id
string

child_business_external_id

existing_client_business_id
numeric string

Existing client business id provided by the client

name
string

Client business name that's managed by the aggregator business

sales_rep_email
string

Email of sales representative of the business that's managed by the aggregator business

survey_business_type
enum {AGENCY, ADVERTISER, APP_DEVELOPER, PUBLISHER}

Business type of surveyed business that's managed by the aggregator business

survey_num_assets
int64

Number of assets surveyed of business that's managed by the aggregator business

survey_num_people
int64

Number of people surveyed of business that's managed by the aggregator business

timezone_id
enum {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480}

Timezone id of business that's managed by the aggregator business

vertical
enum {NOT_SET, ADVERTISING, AUTOMOTIVE, CONSUMER_PACKAGED_GOODS, ECOMMERCE, EDUCATION, ENERGY_AND_UTILITIES, ENTERTAINMENT_AND_MEDIA, FINANCIAL_SERVICES, GAMING, GOVERNMENT_AND_POLITICS, MARKETING, ORGANIZATIONS_AND_ASSOCIATIONS, PROFESSIONAL_SERVICES, RETAIL, TECHNOLOGY, TELECOM, TRAVEL, NON_PROFIT, RESTAURANT, HEALTH, LUXURY, OTHER}

Business vertical of business that's managed by the aggregator business

Тип возврата

Эта конечная точка поддерживаетчтение после записи и будет считывать узел, представленный id в типе возврата.
Struct {
id: numeric string,
name: string,
}

Error Codes

ОшибкаОписание
42004You couldn't create the client business on behalf your client successfully
200Permissions error
100Invalid parameter
190Invalid OAuth 2.0 Access Token
102Session key invalid or no longer valid

Удаление

Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/agencies.

Параметры

ПараметрОписание
business
numeric string or integer

The agency's business.

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
100Invalid parameter
Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/clients.

Параметры

ПараметрОписание
business
numeric string or integer

The client's business.

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
100Invalid parameter
Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/pages.

Параметры

ПараметрОписание
page_id
Page ID

Page ID.

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
3996The page does not belong to this Business Manager.
100Invalid parameter
42001This Page can't be removed because it's already linked to an Instagram business profile. To remove this Page from Business Manager, go to Instagram and convert to a personal account or change the Page linked to your business profile.
415Two factor authentication required. User have to enter a code from SMS or TOTP code generator to pass 2fac. This could happen when accessing a 2fac-protected asset like a page that is owned by a 2fac-protected business manager.
190Invalid OAuth 2.0 Access Token
200Permissions error
Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/instagram_accounts.

Параметры

ПараметрОписание
instagram_account
numeric string

Instagram account ID.

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
100Invalid parameter
200Permissions error
415Two factor authentication required. User have to enter a code from SMS or TOTP code generator to pass 2fac. This could happen when accessing a 2fac-protected asset like a page that is owned by a 2fac-protected business manager.
Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/ad_accounts.

Параметры

ПараметрОписание
adaccount_id
string

Ad account ID.

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
190Invalid OAuth 2.0 Access Token
100Invalid parameter
368The action attempted has been deemed abusive or is otherwise disallowed
Вы можете отменить связывание a Business и an AdAccount, отправив запрос DELETE на адрес /act_{ad_account_id}/agencies.

Параметры

ПараметрОписание
business
numeric string

SELF_EXPLANATORY

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
100Invalid parameter
200Permissions error
Вы можете отменить связывание a Business и a User, отправив запрос DELETE на адрес /{user_id}/businesses.

Параметры

ПараметрОписание
business
numeric string or integer

Business ID

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
3914It looks like you're trying to remove the last admin from this Business Manager. At least one admin is required in Business Manager.
100Invalid parameter
368The action attempted has been deemed abusive or is otherwise disallowed
190Invalid OAuth 2.0 Access Token
Вы можете отменить связывание a Business и a Business, отправив запрос DELETE на адрес /{business_id}/owned_businesses.

Параметры

ПараметрОписание
client_id
numeric string

client_id

Обязательно

Тип возврата

Struct {
success: bool,
}

Error Codes

ОшибкаОписание
3912There was a technical issue and the changes you made to your Business Manager weren't saved. Please try again.
100Invalid parameter
200Permissions error