グラフAPIバージョン

グループの写真

このエッジによりグループのフィードに写真を公開することができます。

読み取り

この操作はサポートされていません。

作成

アップロードまたはURLで写真を公開できます。

アップロードを利用する場合

multipart/form-dataとしてファイルアップロードを行って写真をキャプチャした後、sourceパラメーターを使用する。

POST /v21.0/{group-id}/photos HTTP/1.1
Host: graph.facebook.com

source=%7Bimage-data%7D

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{group-id}/photos',
    array (
      'source' => '{image-data}',
    ),
    '{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(
    "/{group-id}/photos",
    "POST",
    {
        "source": "{image-data}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("source", "{image-data}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/photos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"source": @"{image-data}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/photos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

URLを利用する場合

写真のURLとurlパラメーターを使って、インターネットから公開します。

POST /v21.0/{group-id}/photos HTTP/1.1
Host: graph.facebook.com

url=%7Bimage-url%7D

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{group-id}/photos',
    array (
      'url' => '{image-url}',
    ),
    '{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(
    "/{group-id}/photos",
    "POST",
    {
        "url": "{image-url}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("url", "{image-url}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/photos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"url": @"{image-url}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/photos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

要件

要件のタイプ	説明
アプリレビュー	以下のログインアクセス許可と機能を使用するには、アプリが承認されている必要があります。(クリックして展開)
ログインアクセス許可	`publish_to_groups`
機能	グループAPI
アプリのインストール	アプリがグループにインストールされている必要があります。
トークン	アプリがインストールされているグループのメンバーであるユーザーのユーザーアクセストークン。
アクセス許可	ユーザーが次のアクセス許可をアプリに付与する必要があります: `publish_to_groups`

フィールド

名前	説明	型
`caption`	写真の説明。フィードストーリーのステータスメッセージとして使用されます。	`string`
`message`	写真の説明。	`string`
`published`	写真をすぐに公開したくない場合は、`false`に設定してください。デフォルト値: `true`。	`string`
`source`	フォームデータとしてエンコードされた写真。このフィールドまたは`url`フィールドのいずれかが必要ですが、2つを一緒に使用しないでください。	`multipart/form-data`
`url`	インターネットにすでにアップロードされている写真のURL。このフィールドまたは`source`フィールドのいずれかが必要ですが、2つを一緒に使用しないでください。	`string`

応答

成功すると、次の情報を含む応答を受け取ります。また、このエンドポイントではリードアフターライトがサポートされるので、idにより表されるノードを戻り値の型ですぐに読み取れます。

名前	説明	型
`id`	新たに作成された写真ID	`string`

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。