GET /v20.0/{app-id}/subscriptions 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(
'/{app-id}/subscriptions',
'{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 */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
名前 | 説明 | 型 |
---|---|---|
| サブスクリプションの適用対象がこのオブジェクトタイプであることを示します。 |
|
| アップデートがトリガーされたときに |
|
| サブスクリプション登録の対象の、この |
|
| サブスクリプションがアクティブかどうかを示します。 |
|
次のエッジを使用して、Webhooksサブスクリプションを新規作成できます。
POST /v20.0/{app-id}/subscriptions HTTP/1.1
Host: graph.facebook.com
object=page&callback_url=http%3A%2F%2Fexample.com%2Fcallback%2F&fields=about%2C+picture&include_values=true&verify_token=thisisaverifystring
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->post(
'/{app-id}/subscriptions',
array (
'object' => 'page',
'callback_url' => 'http://example.com/callback/',
'fields' => 'about, picture',
'include_values' => 'true',
'verify_token' => 'thisisaverifystring',
),
'{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 */
Bundle params = new Bundle();
params.putString("object", "page");
params.putString("callback_url", "http://example.com/callback/");
params.putString("fields", "about, picture");
params.putString("include_values", "true");
params.putString("verify_token", "thisisaverifystring");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
params,
HttpMethod.POST,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"object": @"page",
@"callback_url": @"http://example.com/callback/",
@"fields": @"about, picture",
@"include_values": @"true",
@"verify_token": @"thisisaverifystring",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
POSTリクエストでcallback_url
、verify_token
、object
フィールドを指定すると、サブスクリプションを再度有効にできます。
user
へのサブスクリプションは、アプリをインストール済みのユーザーにのみ有効です。page
へのサブスクリプションは、アプリをインストール済みのユーザーにのみ有効です。/{page-id}/subscribed_apps edgeを使用して、ページにアプリをインストールできます。 名前 | 説明 | 型 |
---|---|---|
| サブスクリプションの適用対象がこのオブジェクトタイプであることを示します。 |
|
| アップデートがトリガーされたときに |
|
| サブスクリプション対象にする、この |
|
| 変更通知に新しい値を含めるかどうかを示します。 |
|
| リクエストが有効であることをサーバーに確認するために使用できる任意の文字列。 |
|
コールバックURL が有効で、サブスクリプションに成功した場合、次のようになります。
{ "success": true }
成功しなかった場合は、関連するエラーメッセージが返されます。
次の演算を使用して、すべてのサブスクリプションを削除したり、オブジェクトごとにサブスクリプションを削除したりできます。
DELETE /v20.0/{app-id}/subscriptions HTTP/1.1
Host: graph.facebook.com
object=page
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->delete(
'/{app-id}/subscriptions',
array (
'object' => 'page',
),
'{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 */
Bundle params = new Bundle();
params.putString("object", "page");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{app-id}/subscriptions",
params,
HttpMethod.DELETE,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"object": @"page",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{app-id}/subscriptions"
parameters:params
HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
サブスクリプションから特定のフィールドを削除するには、fields
パラメーターを含めます。
名前 | 説明 | 型 |
---|---|---|
| サブスクリプション削除の対象となる、特定のオブジェクトタイプ。この任意のフィールドが含まれていない場合は、このアプリのすべてのサブスクリプションが削除されます。 |
|
| サブスクリプション対象にする、この |
|
成功した場合は、次のようになります。
{ "success": true }
成功しなかった場合は、関連するエラーメッセージが返されます。
このエッジで更新を実行するには、新しい値を指定して公開演算を実行します。これで、既存のフィールドを上書きすることなく、特定のトピックのサブスクリプションを変更することができます。