Graph API 版本

團體相片

此關係連線支援將相片發佈到群組的動態消息。

讀取

不支援這項操作。

建立

您可經由上載或網址發佈相片。

經由上載

將檔案上載為 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 參數發佈來自互聯網的相片：

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` 欄位，但兩者不得一同使用。	`multipart/form-data`
`url`	已經上載至互聯網的相片之網址。必須填寫此項或 `source`，但兩者不得一同使用。	`string`

回應

如果成功，您將會收到包含以下資訊的回應。此外，此端點支援先寫後讀，並可立即讀取傳回類型中 id 所代表的節點。

名稱	說明	類型
`id`	新建立的相片編號	`string`

更新

不支援這項操作。

刪除

不支援這項操作。