그래프 API 버전

User

Represents a Facebook user.

읽기

Get fields and edges on a User.

Requirements

Type	Description
Access Tokens	User
Permissions	public_profile

새로운 페이지 환경

This endpoint is supported for 새로운 페이지 환경.

예

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.

에지

Edge	설명
`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

반환 유형

이 엔드포인트는 기록 후 읽기 기능을 지원하며 회원님이 게시한 노드를 읽습니다.

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

반환 유형

이 엔드포인트는 기록 후 읽기 기능을 지원하며 회원님이 게시한 노드를 읽습니다.

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}에 DELETE 요청을 만들어 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 Page에서 a User을(를) 분리할 수 있습니다.

매개변수

매개변수	설명
`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 요청을 만들어 an AdAccount에서 a User을(를) 분리할 수 있습니다.

매개변수

매개변수 설명

매개변수	설명
`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 CustomAudience에서 a User을(를) 분리할 수 있습니다.

매개변수

매개변수	설명
`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