图谱 API 版

User

Represents a Facebook user.

读取

Get fields and edges on a User.

Requirements

Type	Description
Access Tokens	User
Permissions	public_profile

New Page Experience

This endpoint is supported for New Page Experience.

例子

Graph API Explorer

GET /v21.0/{person-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(
    '/{person-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(
    "/{person-id}/",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{person-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:@"/{person-id}/"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/{person-id}/

如果你希望详细了解如何使用图谱 API，请阅读我们的图谱 API 指南。

Default Public Profile Fields

The public_profile permission allows apps to read the following fields:

id
first_name
last_name
middle_name
name
name_format
picture
short_name

参数

这个端点不包含任何参数。

字段

字段	描述
`id` numeric string	The app user's App-Scoped User ID. This ID is unique to the app and cannot be used by other apps. 核心
`about` string	Returns no data as of April 4, 2018.
`age_range` AgeRange	The age segment for this person expressed as a minimum and maximum age. For example, more than 18, less than 21. 核心
`birthday` string	The person's birthday. This is a fixed format string, like `MM/DD/YYYY`. However, people can control who can see the year they were born separately from the month and day so this string can be only the year (YYYY) or the month + day (MM/DD) 核心
`education` list<EducationExperience>	Returns no data as of April 4, 2018.
`email` string	The User's primary email address listed on their profile. This field will not be returned if no valid email address is available. 核心
`favorite_athletes` list<Experience>	Athletes the User likes.
`favorite_teams` list<Experience>	Sports teams the User likes.
`first_name` string	The person's first name 核心
`gender` string	The gender selected by this person, `male` or `female`. If the gender is set to a custom value, this value will be based off of the selected pronoun; it will be omitted if the pronoun is neutral. 核心
`hometown` Page	The person's hometown
`id_for_avatars` numeric string	A profile based app scoped ID. It is used to query avatars
`inspirational_people` list<Experience>	The person's inspirational people
`installed` bool	Is the app making the request installed
`is_guest_user` bool	if the current user is a guest user. should always return false.
`languages` list<Experience>	Facebook Pages representing the languages this person knows
`last_name` string	The person's last name 核心
`link` string	A link to the person's Timeline. The link will only resolve if the person clicking the link is logged into Facebook and is a friend of the person whose profile is being viewed. 核心
`local_news_megaphone_dismiss_status` bool	Display megaphone for local news bookmark 停用
`local_news_subscription_status` bool	Daily local news notification 停用
`locale` string	The person's locale 核心停用
`location` Page	The person's current location as entered by them on their profile. This field requires the `user_location` permission. 核心
`meeting_for` list<string>	What the person is interested in meeting for
`middle_name` string	The person's middle name 核心
`name` string	The person's full name 核心默认
`name_format` string	The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering
`political` string	Returns no data as of April 4, 2018.
`quotes` string	The person's favorite quotes
`relationship_status` string	Returns no data as of April 4, 2018.
`religion` string	Returns no data as of April 4, 2018.
`shared_login_upgrade_required_by` timestamp	The time that the shared login needs to be upgraded to Business Manager by
`significant_other` User	The person's significant other
`sports` list<Experience>	Sports played by the person
`supports_donate_button_in_live_video` bool	Whether the user can add a Donate Button to their Live Videos
`third_party_id` string	A string containing an anonymous, unique identifier for the User, for use with third-parties. Deprecated for versions 3.0+. Apps using older versions of the API can get this field until January 8, 2019. Apps installed by the User on or after May 1st, 2018, cannot get this field. 停用
`timezone` float (min: -24) (max: 24)	The person's current timezone offset from UTC 核心停用
`token_for_business` string	A token that is the same across a business's apps. Access to this token requires that the person be logged into your app or have a role on your app. This token will change if the business owning the app changes
`updated_time` datetime	Updated time 停用
`verified` bool	Indicates whether the account has been verified. This is distinct from the `is_verified` field. Someone is considered verified if they take any of the following actions: `* Register for mobile * Confirm their account via SMS * Enter a valid credit card` 停用
`video_upload_limits` VideoUploadLimits	Video upload limits
`website` string	Returns no data as of April 4, 2018.

连线

连线	描述
`accounts` Edge<Page>	Pages the User has a role on.
`ad_studies` Edge<AdStudy>	Ad studies that this User's can view.
`albums` Edge<Album>	The photo albums this person has created
`apprequestformerrecipients` Edge<AppRequestFormerRecipient>	App requests
`apprequests` Edge<AppRequest>	This person's pending requests from an app 核心
`assigned_applications` Edge<Application>	assigned_applications
`assigned_business_asset_groups` Edge<BusinessAssetGroup>	Business asset groups that are assign to this business scoped user
`assigned_pages` Edge<Page>	Pages that are assigned to this business scoped user
`assigned_product_catalogs` Edge<ProductCatalog>	Product catalogs that are assigned to this business scoped user
`business_users` Edge<BusinessUser>	Business users corresponding to the user
`businesses` Edge<Business>	Businesses associated with the user
`conversations` Edge<UnifiedThread>	Facebook Messenger conversation
`custom_labels` Edge<PageUserMessageThreadLabel>	custom_labels
`feed` Edge<Post>	The posts and links published by this person or others on their profile
`ids_for_apps` Edge<UserIDForApp>	Businesses can claim ownership of multiple apps using Business Manager. This edge returns the list of IDs that this user has in any of those other apps
`ids_for_business` Edge<UserIDForApp>	Businesses can claim ownership of multiple apps using Business Manager. This edge returns the list of IDs that this user has in any of those other apps
`ids_for_pages` Edge<UserIDForPage>	Businesses can claim ownership of apps and pages using Business Manager. This edge returns the list of IDs that this user has in any of the pages owned by this business
`likes` Edge<Page>	All the Pages this person has liked
`live_videos` Edge<LiveVideo>	Live videos from this person
`music` Edge<Page>	Music this person likes
`payment.subscriptions` Edge<PaymentSubscription>	Payment subscriptions
`permissions` Edge<Permission>	The permissions that the person has granted this app 核心
`photos` Edge<Photo>	Photos the person is tagged in or has uploaded
`picture` Edge<ProfilePictureSource>	The person's profile picture 核心
`rich_media_documents` Edge<Canvas>	A list of rich media documents belonging to Pages that the user has advertiser permissions on
`videos` Edge<Video>	Videos the person is tagged in or uploaded

错误代码

错误	描述
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token
104	Incorrect signature
368	The action attempted has been deemed abusive or is otherwise disallowed
459	The session is invalid because the user has been checkpointed
613	Calls to this api have exceeded the rate limit.
80004	There 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.
230	Permissions disallow message to user
483	The session is invalid because the user is in consent app blocking

创建

你无法在此端点执行该操作。

更新

你可以向 /{user_id} 发出 POST 请求，以更新 a User 。

参数

参数	描述
`emoji_color_pref` int64	emoji color preference.
`firstname` string	This person's first name
`lastname` string	This person's last name
`local_news_megaphone_dismiss_status` enum {YES, NO}	Dismisses local news megaphone
`local_news_subscription_status` enum {STATUS_ON, STATUS_OFF}	Preference for setting local news notifications
`name` string	Used for test accounts only. Name for this account
`password` string	Used for test accounts only. Password for this account

返回类型

这个端点支持先写后读，并会读取接收你的 POST 请求的节点。

Struct {

success: bool,

}

错误代码

错误	描述
190	Invalid OAuth 2.0 Access Token
459	The session is invalid because the user has been checkpointed
368	The action attempted has been deemed abusive or is otherwise disallowed
200	Permissions error
100	Invalid parameter
240	Desktop applications cannot call this function for other users
102	Session key invalid or no longer valid
2500	Error parsing graph query
210	User not visible

你可以向 /{custom_audience_id}/users 发出 POST 请求，以更新 a User 。

例子

Graph API Explorer

POST /v21.0/<CUSTOM_AUDIENCE_ID>/users HTTP/1.1
Host: graph.facebook.com

payload=%7B%22schema%22%3A%5B%22EMAIL%22%2C%22LOOKALIKE_VALUE%22%5D%2C%22data%22%3A%5B%5B%229b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254%22%2C44.5%5D%2C%5B%228cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee%22%2C140%5D%2C%5B%224eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a%22%2C0%5D%2C%5B%2298df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56%22%2C0.9%5D%5D%7D

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/<CUSTOM_AUDIENCE_ID>/users',
    array (
      'payload' => '{"schema":["EMAIL","LOOKALIKE_VALUE"],"data":[["9b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254",44.5],["8cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee",140],["4eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a",0],["98df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56",0.9]]}',
    ),
    '{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(
    "/<CUSTOM_AUDIENCE_ID>/users",
    "POST",
    {
        "payload": "{\"schema\":[\"EMAIL\",\"LOOKALIKE_VALUE\"],\"data\":[[\"9b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254\",44.5],[\"8cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee\",140],[\"4eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a\",0],[\"98df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56\",0.9]]}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("payload", "{\"schema\":[\"EMAIL\",\"LOOKALIKE_VALUE\"],\"data\":[[\"9b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254\",44.5],[\"8cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee\",140],[\"4eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a\",0],[\"98df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56\",0.9]]}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/<CUSTOM_AUDIENCE_ID>/users",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"payload": @"{\"schema\":[\"EMAIL\",\"LOOKALIKE_VALUE\"],\"data\":[[\"9b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254\",44.5],[\"8cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee\",140],[\"4eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a\",0],[\"98df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56\",0.9]]}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/<CUSTOM_AUDIENCE_ID>/users"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

curl -X POST \
  -F 'payload={
       "schema": [
         "EMAIL",
         "LOOKALIKE_VALUE"
       ],
       "data": [
         [
           "9b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254",
           44.5
         ],
         [
           "8cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee",
           140
         ],
         [
           "4eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a",
           0
         ],
         [
           "98df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56",
           0.9
         ]
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CUSTOM_AUDIENCE_ID>/users

如果你希望详细了解如何使用图谱 API，请阅读我们的图谱 API 指南。

参数

参数	描述
`payload` Object	Payload representing users to add
`schema` string	`EMAIL_SHA256`, `PHONE_SHA256`, `MOBILE_ADVERTISER_ID`. One can also pass an array of multiple keys for multi-key match. Supported key types includes: `EXTERN_ID` `EMAIL` `PHONE` `GEN` `DOBY` `DOBM` `DOBD` `LN` `FN` `FI` `CT` `ST` `ZIP` `MADID` `COUNTRY` The multi-key array is of the form `["EMAIL", "LN", "FN", "ZIP"]`
`is_raw` boolean	Is the key raw? If the keys are combinational keys like "LN_FN_ZIP", set this to `false`, otherwise set this to `true`. Default to false
`data` list<JSON array>	Array with users data. If the multi-key feature is used, a two-dimensional array of the form `[["<HASHED_EMAIL>", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"], ["", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"]]` should be passed.In case a key is unknown, it should be left blank.
`app_ids` list<int>	App ids used by the users being uploaded. This field is required when `schema` is a Facebook UID and the IDs were collected by an App integration. e.g. `[1234,5678]`
`page_ids` list<Page ID>	Page ids used by the users being uploaded. This field is required when `schema` is a Facebook UID and the IDs were collected by a Page webhook integration. e.g. `[1234,5678]`
`data_source` Object	Indicates by which method the custom audience was created, defined by the `type` and `subtype` of the `data_source`
`type` enum {UNKNOWN, FILE_IMPORTED, EVENT_BASED, SEED_BASED, THIRD_PARTY_IMPORTED, COPY_PASTE, CONTACT_IMPORTER, HOUSEHOLD_AUDIENCE}	Type of the custom audience
`sub_type` enum {ANYTHING, NOTHING, HASHES, USER_IDS, HASHES_OR_USER_IDS, MOBILE_ADVERTISER_IDS, EXTERNAL_IDS, MULTI_HASHES, TOKENS, EXTERNAL_IDS_MIX, HOUSEHOLD_EXPANSION, SUBSCRIBER_LIST, WEB_PIXEL_HITS, MOBILE_APP_EVENTS, MOBILE_APP_COMBINATION_EVENTS, VIDEO_EVENTS, WEB_PIXEL_COMBINATION_EVENTS, PLATFORM, MULTI_DATA_EVENTS, IG_BUSINESS_EVENTS, STORE_VISIT_EVENTS, INSTANT_ARTICLE_EVENTS, FB_EVENT_SIGNALS, FACEBOOK_WIFI_EVENTS, AR_EXPERIENCE_EVENTS, AR_EFFECTS_EVENTS, MESSENGER_ONSITE_SUBSCRIPTION, WHATSAPP_SUBSCRIBER_POOL, MARKETPLACE_LISTINGS, AD_CAMPAIGN, GROUP_EVENTS, ENGAGEMENT_EVENT_USERS, CUSTOM_AUDIENCE_USERS, PAGE_FANS, CONVERSION_PIXEL_HITS, APP_USERS, S_EXPR, DYNAMIC_RULE, CAMPAIGN_CONVERSIONS, WEB_PIXEL_HITS_CUSTOM_AUDIENCE_USERS, MOBILE_APP_CUSTOM_AUDIENCE_USERS, COMBINATION_CUSTOM_AUDIENCE_USERS, VIDEO_EVENT_USERS, FB_PIXEL_HITS, IG_PROMOTED_POST, PLACE_VISITS, OFFLINE_EVENT_USERS, EXPANDED_AUDIENCE, SEED_LIST, PARTNER_CATEGORY_USERS, PAGE_SMART_AUDIENCE, MULTICOUNTRY_COMBINATION, PLATFORM_USERS, MULTI_EVENT_SOURCE, SMART_AUDIENCE, LOOKALIKE_PLATFORM, SIGNAL_SOURCE, MAIL_CHIMP_EMAIL_HASHES, CONSTANT_CONTACTS_EMAIL_HASHES, COPY_PASTE_EMAIL_HASHES, CUSTOM_DATA_TARGETING, CONTACT_IMPORTER, DATA_FILE}	Subtype of the custom audience
`metadata` Object
`calculated_date` datetime
`schema_version` string
`whatsapp_subscriber_source` int64
`session` Object	Information about the session. Sessions are used when you have a lot of users to upload. For example, if you have 1 million users to upload, you need to split them into at least 100 requests because each request can only take 10k users. Specify the session info so that you can track if the session has finished or not.
`session_id` int64	Advertiser generated session identifier, used to track the session. Needs to be unique in the same ad account.
`estimated_num_total` int64	Estimated total num of users to be uploaded in this session, used by Facebook systems to better process this session.
`batch_seq` int64	A 1 based sequence number to identify the request in the session.
`last_batch_flag` boolean	`true` mean this request is the last request in this session. You must mark the last request otherwise Facebook doesn't know the session has ended

返回类型

这个端点支持先写后读，并会读取接收你的 POST 请求的节点。

Struct {

audience_id: numeric string,

session_id: numeric string,

num_received: int32,

num_invalid_entries: int32,

invalid_entry_samples: Map {

string: string

}

错误代码

错误	描述
100	Invalid parameter
200	Permissions error
2650	Failed to update the custom audience
190	Invalid OAuth 2.0 Access Token
105	The number of parameters exceeded the maximum for this operation

删除

Delete a test user

你可以向 /{user_id} 发出“删除”请求来删除 a User 。

参数

这个端点不包含任何参数。

返回类型

Struct {

success: bool,

}

错误代码

错误	描述
2903	Cannot delete this test account
2904	Cannot delete the OG Test User
240	Desktop applications cannot call this function for other users
100	Invalid parameter
102	Session key invalid or no longer valid
190	Invalid OAuth 2.0 Access Token
200	Permissions error

你可以向 /{page_id}/blocked 发出 DELETE 请求，将 a User 与 a Page 取消关联。

参数

参数	描述
`asid` user/page ID	App Scoped User ID to unblock
`psid` UID	Page Scoped User ID to unblock
`uid` UID	Deprecated. Same as `user`
`user` UID	List of User or Page IDs to unblock. This or `uid` is required

返回类型

Struct {

success: bool,

}

错误代码

错误	描述
100	Invalid parameter

你可以向 /act_{ad_account_id}/assigned_users 发出 DELETE 请求，将 a User 与 an AdAccount 取消关联。

参数

参数描述

参数	描述
`user` UID	Business user id or system user id 必填

user

UID

Business user id or system user id

必填

返回类型

Struct {

success: bool,

}

错误代码

错误	描述
3919	There was an unexpected technical issue. Please try again.
100	Invalid parameter
368	The action attempted has been deemed abusive or is otherwise disallowed

你可以向 /{custom_audience_id}/users 发出 DELETE 请求，将 a User 与 a CustomAudience 取消关联。

参数

参数	描述
`payload` Object	Payload representing users to delete
`schema` string	`EMAIL_SHA256`, `PHONE_SHA256`, `MOBILE_ADVERTISER_ID`. One can also pass an array of multiple keys for multi-key match. Supported key types includes: `EXTERN_ID` `EMAIL` `PHONE` `GEN` `DOBY` `DOBM` `DOBD` `LN` `FN` `FI` `CT` `ST` `ZIP` `MADID` `COUNTRY` The multi-key array is of the form `["EMAIL", "LN", "FN", "ZIP"]`
`is_raw` boolean	Is the key raw? If the keys are combinational keys like "LN_FN_ZIP", set this to `false`, otherwise set this to `true`. Default to false
`data` list<JSON array>	Array with users data. If the multi-key feature is used, a two-dimensional array of the form `[["<HASHED_EMAIL>", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"], ["", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"]]` should be passed.In case a key is unknown, it should be left blank.
`app_ids` list<int>	App ids used by the users being uploaded. This field is required when `schema` is a Facebook UID and the IDs were collected by an App integration. e.g. `[1234,5678]`
`page_ids` list<Page ID>	Page ids used by the users being uploaded. This field is required when `schema` is a Facebook UID and the IDs were collected by a Page webhook integration. e.g. `[1234,5678]`
`data_source` Object	Indicates by which method the custom audience was created, defined by the `type` and `subtype` of the `data_source`
`type` enum {UNKNOWN, FILE_IMPORTED, EVENT_BASED, SEED_BASED, THIRD_PARTY_IMPORTED, COPY_PASTE, CONTACT_IMPORTER, HOUSEHOLD_AUDIENCE}	Type of the custom audience
`sub_type` enum {ANYTHING, NOTHING, HASHES, USER_IDS, HASHES_OR_USER_IDS, MOBILE_ADVERTISER_IDS, EXTERNAL_IDS, MULTI_HASHES, TOKENS, EXTERNAL_IDS_MIX, HOUSEHOLD_EXPANSION, SUBSCRIBER_LIST, WEB_PIXEL_HITS, MOBILE_APP_EVENTS, MOBILE_APP_COMBINATION_EVENTS, VIDEO_EVENTS, WEB_PIXEL_COMBINATION_EVENTS, PLATFORM, MULTI_DATA_EVENTS, IG_BUSINESS_EVENTS, STORE_VISIT_EVENTS, INSTANT_ARTICLE_EVENTS, FB_EVENT_SIGNALS, FACEBOOK_WIFI_EVENTS, AR_EXPERIENCE_EVENTS, AR_EFFECTS_EVENTS, MESSENGER_ONSITE_SUBSCRIPTION, WHATSAPP_SUBSCRIBER_POOL, MARKETPLACE_LISTINGS, AD_CAMPAIGN, GROUP_EVENTS, ENGAGEMENT_EVENT_USERS, CUSTOM_AUDIENCE_USERS, PAGE_FANS, CONVERSION_PIXEL_HITS, APP_USERS, S_EXPR, DYNAMIC_RULE, CAMPAIGN_CONVERSIONS, WEB_PIXEL_HITS_CUSTOM_AUDIENCE_USERS, MOBILE_APP_CUSTOM_AUDIENCE_USERS, COMBINATION_CUSTOM_AUDIENCE_USERS, VIDEO_EVENT_USERS, FB_PIXEL_HITS, IG_PROMOTED_POST, PLACE_VISITS, OFFLINE_EVENT_USERS, EXPANDED_AUDIENCE, SEED_LIST, PARTNER_CATEGORY_USERS, PAGE_SMART_AUDIENCE, MULTICOUNTRY_COMBINATION, PLATFORM_USERS, MULTI_EVENT_SOURCE, SMART_AUDIENCE, LOOKALIKE_PLATFORM, SIGNAL_SOURCE, MAIL_CHIMP_EMAIL_HASHES, CONSTANT_CONTACTS_EMAIL_HASHES, COPY_PASTE_EMAIL_HASHES, CUSTOM_DATA_TARGETING, CONTACT_IMPORTER, DATA_FILE}	Subtype of the custom audience
`metadata` Object
`calculated_date` datetime
`schema_version` string
`whatsapp_subscriber_source` int64
`session` Object	Information about the session. Sessions are used when you have a lot of users to upload. For example, if you have 1 million users to upload, you need to split them into at least 100 requests because each request can only take 10k users. Specify the session info so that you can track if the session has finished or not.
`session_id` int64	Advertiser generated session identifier, used to track the session. Needs to be unique in the same ad account.
`estimated_num_total` int64	Estimated total num of users to be uploaded in this session, used by Facebook systems to better process this session.
`batch_seq` int64	A 1 based sequence number to identify the request in the session.
`last_batch_flag` boolean	`true` mean this request is the last request in this session. You must mark the last request otherwise Facebook doesn't know the session has ended

返回类型

Struct {

audience_id: numeric string,

session_id: numeric string,

num_received: int32,

num_invalid_entries: int32,

invalid_entry_samples: Map {

string: string

}

错误代码

错误	描述
80003	There 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#custom-audience.
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token
2650	Failed to update the custom audience
105	The number of parameters exceeded the maximum for this operation