Version API du graphe

Albums de groupe

Albums photo créés pour un groupe.

Lecture

Renvoie un ensemble d’albums sur le groupe.

GET /v19.0/{group-id}/albums 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(
    '/{group-id}/albums',
    '{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}/albums",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/albums",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

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

Conditions requises

Condition requise	Description
Contrôle app	Votre application doit être approuvée pour la fonctionnalité API Groups.
Installation d’app	L'application doit être installée sur le groupe.
Tokens	Token d’accès utilisateur·ice.

Champs

Lorsque vous demandez les champs Album suivants au moyen d’un élargissement de champ, seules les personnes qui ont accordé l’autorisation groups_access_member_info à votre application seront incluses :

from
likes
reaction

Publication

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

name=%7Balbum-name%7D&message=%7Balbum-description%7D&privacy=%7Bprivacy-settings%7D

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

Bundle params = new Bundle();
params.putString("name", "{album-name}");
params.putString("message", "{album-description}");
params.putString("privacy", "{privacy-settings}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/albums",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"name": @"{album-name}",
  @"message": @"{album-description}",
  @"privacy": @"{privacy-settings}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/albums"
                                      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

Paramètre	Description	Type
`name`	Nom donné à l’album. Ce champ est obligatoire.	`string`
`message`	Description de l’album figurant dans le Fil sous forme de statut.	`string`

Réponse

Nom	Description	Type
id	ID de l’album nouvellement créé.	`string`

Suppression

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

Mise à jour

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