グラフAPIバージョン

Page Ads Posts

読み取り

AdsPosts

Requirements

You will need:
  • The pages_manage_ads permission
  • The pages_show_list permission
  • The ads_management permission
  • The person requesting the access token must be able to perform the ADVERTISE task on the Page.

New Page Experience

このエンドポイントは新デザインのページに対応しています。

Graph API Explorer
GET /v24.0/{page-id}/ads_posts 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(
 '/{page-id}/ads_posts',
 '{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(
 "/{page-id}/ads_posts",
 function (response) {
 if (response && !response.error) {
 /* handle the result */
 }
 }
);
/* make the API call */
new GraphRequest(
 AccessToken.getCurrentAccessToken(),
 "/{page-id}/ads_posts",
 null,
 HttpMethod.GET,
 new GraphRequest.Callback() {
 public void onCompleted(GraphResponse response) {
 /* handle the result */
 }
 }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
 initWithGraphPath:@"/{page-id}/ads_posts"
 parameters:params
 HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
 id result,
 NSError *error) {
 // Handle the result
}];
グラフAPIを使用する方法については、グラフAPIの使用ガイドをご覧ください。

パラメーター

パラメーター説明
exclude_dynamic_ads
boolean
デフォルト値: false

exclude_dynamic_ads

include_inline_create
boolean
デフォルト値: false

include_inline_create

since
datetime/timestamp

since

until
datetime/timestamp

until

項目

このエッジからの読み込むではJSONフォーマットの結果が返されます:

{ "data": [], "paging": {}, "summary": {} }

data

PagePostノードの一覧です。

paging

ページネ―ションについて詳しくは、グラフAPIガイドをご覧ください。

summary

エッジの集計情報(数値など)。サマリーパラメータで取得するフィールドを指定します(サマリー=total_countなど)。

フィールド説明
total_count
unsigned int32

total_count

エラーコード

エラー詳細
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
200Permissions error
190Invalid OAuth 2.0 Access Token
100Invalid parameter

作成

このエンドポイントではこの操作を実行できません。

更新中...

このエンドポイントではこの操作を実行できません。

削除中です

このエンドポイントではこの操作を実行できません。

AltStyle によって変換されたページ (->オリジナル) /