Graph API 版本

Saved Audience

To improve how advertisers create and manage their audiences, Saved Audiences that have not been used in any active ad sets in over two years will be automatically deleted on a rolling basis. For more information, see the Custom Audiences Overview documentation.

閱讀中

Object representing a targeting spec that has been saved for later use.

例子

Graph API Explorer

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

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

如果想了解如何使用 Graph API，請參閱我們的使用 Graph API 指南。

參數

這個端點沒有任何參數。

欄位

欄位	描述
`id` numeric string	ID 預設
`approximate_count_lower_bound` integer	Estimated lower bound on reach of this saved audience as a 64 bit int
`approximate_count_upper_bound` integer	Estimated upper bound on reach of this saved audience as a 64 bit int
`description` string	Description of this saved audience provided by owner
`name` string	Name of this saved audience 預設
`permission_for_actions` AudiencePermissionForActions	Permissions for actions to the audience
`run_status` enum	Whether the saved audience is active or deleted
`sentence_lines` list	The targeting sentence lines of this saved audience
`targeting` Targeting	Target spec saved in this audience
`time_created` datetime	Creation time of this saved audience
`time_updated` datetime	Last time the saved audience being updated by its owner

Error Codes

錯誤	說明
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token
270	This Ads API request is not allowed for apps with development access level (Development access is by default for all apps, please request for upgrade). Make sure that the access token belongs to a user that is both admin of the app and admin of the ad account

建立中

你無法在此端點執行此操作。

更新中

你無法在此端點執行此操作。

正在刪除

你無法在此端點執行此操作。