Version API du graphe

Photos de groupe

Cette arête vous permet de publier une photo dans le fil d'un groupe.

Lecture

Cette opération n’est pas prise en charge.

Création

Vous pouvez publier des photos via une importation ou une URL.

Via une importation

Capturez une photo via une importation de fichier en tant que multipart/form-data, puis utilisez le paramètre 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
}];

Via une URL

Publiez une photo qui est sur Internet en utilisant son URL et le paramètre 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
}];

Conditions requises

Type de condition requise	Description
Contrôle app	Votre application doit être approuvée pour les autorisations de connexion et les fonctionnalités suivantes (cliquez dessus pour les développer) :
Autorisations de connexion	`publish_to_groups`
Fonctionnalités	API Groups
Installation de l’application	L'application doit être installée sur le groupe.
Tokens	Token d’accès pour un utilisateur ou une utilisatrice qui est membre du groupe sur lequel l’application est installée.
Autorisations	L’utilisateur ou l’utilisatrice doit accorder l’autorisation suivante à votre application : `publish_to_groups`

Champs

Nom	Description	Type
`caption`	Description de la photo, utilisée comme message de statut associé dans les stories de fil.	`string`
`message`	Description de la photo.	`string`
`published`	Définir sur `false` si vous ne souhaitez pas publier la photo dans l’immédiat. Valeur par défaut : `true`.	`string`
`source`	Photo, encodée en tant que données de formulaire. Vous devez utiliser ce paramètre ou le champ `url`, mais pas les deux en même temps.	`multipart/form-data`
`url`	URL d’une photo qui est déjà importée sur Internet. Vous devez utiliser ce paramètre ou `source`, mais pas les deux en même temps.	`string`

Réponse

En cas de réussite, vous recevez une réponse avec les informations ci-dessous. En outre, ce point de terminaison prend en charge la lecture après écriture et il peut lire immédiatement le nœud représenté par id dans le type de retour.

Nom	Description	Type
`id`	ID photo que vous venez de créer	`string`

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.