Graph API
Версия API Graph

Фото группы

Эта конечная точка позволяет публиковать фото в ленте группы.

Чтение

Эта операция не поддерживается.

Создание

Публиковать фото можно путем загрузки или указания 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

Функции

Groups API

Установка приложения

Приложение должно быть установлено в группе.

Маркеры

Маркер доступа пользователя для участника группы, в которой установлено приложение.

Разрешения

Пользователь должен предоставить приложению следующее разрешение:

publish_to_groups

Поля

Имя Описание Тип

caption

Описание фото, которое используется в качестве сообщения статуса в любой истории.

string

message

Описание фото.

string

published

Если вы не хотите публиковать фото сразу же, установите значение false. Значение по умолчанию: true.

string

source

Фото, закодированное в формате данных формы. Необходимо задать это поле либо поле url, но не оба одновременно.

multipart/form-data

url

URL фото, уже загруженного в Интернет. Необходимо задать это поле либо поле source, но не оба одновременно.

string

Ответ

В случае успеха вы получите ответ с описанной ниже информацией. Кроме того, эта конечная точка поддерживает чтение после записи и может сразу считывать узел, которому соответствует id в возвращенном типе.

Имя Описание Тип

id

ID созданной фотографии

string

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.