Graph API
Graph API-Version

Anfrage /{request-id}

Eine individuelle Spieleanfrage, die eine Person erhalten hat und die von einer App oder einer anderen Person gesendet wurde.

Verwandte Leitfäden

Lesen

Graph API Explorer
GET /v21.0/{request-id} 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(
    '/{request-id}',
    '{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(
    "/{request-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{request-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{request-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Berechtigungen

  • Ein Nutzer-Zugriffsschlüssel ist erforderlich, wenn du eine Anfrage durchführst und dabei nur die Anfrageobjekt-ID verwendest und Informationen über den*die Empfänger*in der Anfrage erhalten möchtest. Die Anfrage muss an die Person gesendet worden sein, deren Zugriffsschlüssel du verwendest.
  • Ein App-Zugriffsschlüssel kann verwendet werden, wenn du eine Anfrage durchführst und die verkettete Anfrageobjekt-ID und den Benutzer-ID-String verwendest oder wenn du nur die Anfrageobjekt-ID verwendest, aber keine Empfängerinformationen benötigst. Weitere Informationen zu dieser ID findest du in der Anfragendokumentation.

Felder

Name Beschreibung Typ

id

Die Anfrageobjekt-ID.

string

application

Mit der Afrage verknüpfte App.

App

to

Empfänger*in der Anfrage.

User

from

Mit der Anfrage verknüpfte*r Absender*in. Diese ist nur enthalten für Anfragen von Benutzer*innen an Benutzer*innen.

User

message

Ein String, der die Anfrage beschreibt.

string

created_time

Ein Zeitstempel für die Erstellung der Anfrage.

datetime

Veröffentlichen

Mit diesem Endpunkt ist das Veröffentlichen nicht möglich.

Anfragen werden über den Spieleanfragendialog veröffentlicht. Wenn deine App ein Spiel ist, kannst du App-Anfragen veröffentlichen, indem du die /{user-id}/apprequests-Edge verwendest.

Löschen

DELETE /v21.0/{request-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->delete(
    '/{request-id}',
    array (),
    '{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(
    "/{request-id}",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{request-id}",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{request-id}"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Berechtigungen

  • Ein Nutzer-Zugriffsschlüssel ist erforderlich, wenn du nur die Anfrageobjekt-ID verwendest. Die Anfrage muss außerdem an die Person gesendet worden sein, deren Zugriffsschlüssel du verwendest.
  • Ein App-Zugriffsschlüssel kann verwendet werden, wenn du die verkettete Anfrageobjekt-ID und den Nutzer-ID-String verwendest.

Felder

Zum Löschen sind keine Felder erforderlich.

Antwort

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

{
  "success": true
}

Ansonsten wird eine entsprechende Fehlermeldung ausgegeben.

Aktualisieren

Mit diesem Endpunkt sind keine Aktualisierungen möglich.