إصدار ‏‎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‎

خطأالوصف
368The action attempted has been deemed abusive or is otherwise disallowed
100Invalid parameter
200Permissions error
190Invalid OAuth 2.0 Access Token
270This 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

إنشاء

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ التحديث

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ الحذف

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.