グラフAPIバージョン

Page Picture

The profile picture of a Facebook Page.

読み取り

Get the profile picture of a Facebook Page.

New Page Experience

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

Permissions

The person requesting the Page access token must be able to perform the MANAGE task on the Page.
The pages_read_engagement permission.
The pages_show_list permission.

An App or User access token.
The Pages Public Metadata Access feature

例

Graph API Explorer

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

Bundle params = new Bundle();
params.putString("redirect", "0");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/picture",
    params,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"redirect": @"0",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/picture"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

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

グラフAPIを使用する方法については、グラフAPIの使用ガイドをご覧ください。

パラメーター

パラメーター	説明
`height` integer	The height of this picture in pixels.
`redirect` boolean	デフォルト値: `true` By default the picture edge will return a picture instead of a JSON response. If you want the picture edge to return JSON that describes the image set `redirect=0` when you make the request.
`type` enum{small, normal, album, large, square}	The size of this picture. It can be one of the following values: small, normal, large, square.
`width` integer	The width of this picture in pixels.

項目

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

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

`data`

A single ProfilePictureSource node.

`paging`

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

エラーコード

エラー	詳細
190	Invalid OAuth 2.0 Access Token
200	Permissions error
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
459	The session is invalid because the user has been checkpointed
483	The session is invalid because the user is in consent app blocking
80001	There 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.

作成

pictureのエッジにPOSTリクエストを以下のパスで送信できます:

/{page_id}/picture

このエッジにPOSTする場合、a ProfilePictureSourceが作成されます。

Permissions

The person requesting the Page access token must be able to perform the MANAGE task on the Page.
The pages_read_engagement permission.
The pages_show_list permission.

パラメーター

パラメーター	説明
`android_key_hash` string	Android key hash for the proxied app ID.
`burn_media_effect` boolean	burn_media_effect
`caption` UTF-8 string	The caption for a profile pic 絵文字をサポートします
`composer_session_id` string	Composer session ID
`frame_entrypoint` string	frame_entrypoint
`has_umg` boolean	Whether or not the picture uploaded has edits made in the unified media gallery
`height` int64	Height for crop
`ios_bundle_id` string	iOS bundle ID for the proxied app ID.
`media_effect_ids` list<int>	Set of Media Effect IDs that were used on this pic
`media_effect_source_object_id` int	The FBID of the media from which the effects were sourced.
`msqrd_mask_id` string	MSQRD mask ID that was used to create this pic 古いバージョン
`photo` numeric string	ID of the photo to use as the profile pic
`picture` URL	URL of the picture to upload
`profile_pic_method` string	Method of the profile pic change for logging
`profile_pic_source` string	Source of the profile pic change for logging
`proxied_app_id` int	ID of the proxied app that performed this action
`qn` string	Waterfall logger session ID
`reuse` boolean	Whether to reuse an existing profile pic
`scaled_crop_rect` Object	Dictionary with fractional (scaled) keys x/y/width/height for crop
`x` float
`y` float
`width` float
`height` float
`set_profile_photo_shield` string	Whether to set Women in Emerging Markets Profile Photo Safety Shield on or off
`sticker_id` int	Sticker ID for profile pics with sticker overlays
`sticker_source_object_id` int	The FBID of the source media
`suppress_stories` boolean	suppress_stories
`width` int64	Width for crop
`x` int64	Top-left x-coordinate for crop
`y` int64	Top-left y-coordinate for crop

戻り値の型

Struct {

success: bool,

}

エラーコード

エラー	詳細
368	The action attempted has been deemed abusive or is otherwise disallowed
332	The image you tried to upload is too small. Please try again with a larger image.
240	Desktop applications cannot call this function for other users
190	Invalid OAuth 2.0 Access Token
200	Permissions error
100	Invalid parameter
283	That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata

更新中…

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

削除中です

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