그래프 API 버전

Page Picture

The profile picture of a Facebook Page.

읽기

Get the profile picture of a Facebook Page.

새로운 페이지 환경

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

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

이 에지에 게시할 때 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 Deprecated
`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

업데이트 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

삭제 중

이 엔드포인트에서 수행할 수 없는 작업입니다.