Graph API 版本

Page Call To Action

閱讀中

Returns data on PageCallToAction node.

新版專頁體驗

This endpoint is supported for 新版專頁體驗.

例子

Graph API Explorer
GET /v21.0/{page-call-to-action-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(
    '/{page-call-to-action-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(
    "/{page-call-to-action-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-call-to-action-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:@"/{page-call-to-action-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
如果想了解如何使用 Graph API,請參閱我們的使用 Graph API 指南

Requirements

TypeDescription

App Review

Your app must be be approved for the following login permissions and features.

Login permissions

None

Features

Page Public Content Access

Tokens

A User access token for a User who has a role on the Page

Permissions

None

參數

這個端點沒有任何參數。

欄位

欄位描述
id
numeric string

ID of the call-to-action

android_app

App that stores the destination info on Android

android_deeplink
string

Destination deeplink for the call-to-action on Android

android_destination_type
enum

Destination type for the call-to-action on Android

android_package_name
string

Destination app for the call-to-action on Android

android_url
string

Destination url for the call-to-action on Android

created_time
datetime

Time when the call-to-action was created

email_address
string

Email address that can be contacted by a user

from

Page that owns the call-to-action

intl_number_with_plus
string

International phone number with plus that can be called by a phone

iphone_app

App that stores the destination info on iPhone

iphone_deeplink
string

Destination deeplink for the call-to-action on iPhone

iphone_destination_type
enum

Destination type for the call-to-action on iPhone

iphone_url
string

Destination url for the call-to-action on iPhone

status
enum

Current running status of this action

type
enum

The type of action

updated_time
datetime

Time when the call-to-action was last updated

web_destination_type
enum

Destination type for the call-to-action on desktop

web_url
string

Destination url for the call-to-action on desktop

Error Codes

錯誤說明
100Invalid parameter

建立中

你無法在此端點執行此操作。

更新中

This endpoint is deprecated and can no longer be used.

You can update a PageCallToAction by making a POST request to /{page_call_to_action_id}.

Requirements

TypeDescription

App Review

Your app must be be approved for the following login permissions and features.

Login permissions

pages_manage_cta

Features

None

Tokens

A Page access token for an admin of the Page

Permissions

pages_manage_cta

參數

參數描述
android_app_id
int

ID of the App that stores the destination info on Android

android_destination_type
enum {WEBSITE, APP_DEEPLINK, FACEBOOK_APP, PHONE_CALL, MESSENGER, EMAIL, SHOP_ON_FACEBOOK, NONE, BECOME_A_VOLUNTEER, FOLLOW, MINI_SHOP, MARKETPLACE_INVENTORY_PAGE, MOBILE_CENTER, MENU_ON_FACEBOOK}

Destination type for the call-to-action on Android

android_package_name
string

Destination app for the call-to-action on Android

android_url
URL

Destination url for the call-to-action on Android

email_address
string

Email address that can be contacted by a user

intl_number_with_plus
string

International phone number with plus that can be called through a phone

iphone_app_id
int

ID fo the App that stores the destination info on iPhone

iphone_destination_type
enum {WEBSITE, APP_DEEPLINK, FACEBOOK_APP, PHONE_CALL, MESSENGER, EMAIL, SHOP_ON_FACEBOOK, NONE, BECOME_A_VOLUNTEER, FOLLOW, MINI_SHOP, MARKETPLACE_INVENTORY_PAGE, MENU_ON_FACEBOOK}

Destination type for the call-to-action on iPhone

iphone_url
URL

Destination url for the call-to-action on iPhone

type
enum {BOOK_NOW, REQUEST_QUOTE, CALL_NOW, CHARITY_DONATE, CONTACT_US, DONATE_NOW, MESSAGE, OPEN_APP, PLAY_NOW, SHOP_NOW, SIGN_UP, WATCH_NOW, GET_OFFER, GET_OFFER_VIEW, BOOK_APPOINTMENT, LISTEN, EMAIL, LEARN_MORE, REQUEST_APPOINTMENT, GET_DIRECTIONS, BUY_TICKETS, PLAY_MUSIC, VISIT_GROUP, SHOP_ON_FACEBOOK, LOCAL_DEV_PLATFORM, INTERESTED, WOODHENGE_SUPPORT, BECOME_A_VOLUNTEER, VIEW_SHOP, PURCHASE_GIFT_CARDS, FOLLOW_PAGE, ORDER_FOOD, VIEW_INVENTORY, MOBILE_CENTER, VIEW_MENU, CHECK_IN}

The type of action

web_destination_type
enum {EMAIL, MESSENGER, NONE, WEBSITE, SHOP_ON_FACEBOOK, BECOME_SUPPORTER, BECOME_A_VOLUNTEER, FOLLOW, MOBILE_CENTER}

Destination type for the call-to-action on desktop

web_url
URL

Destination url for the call-to-action on desktop

傳回類型

This endpoint supports 寫入後讀取 and will read the node to which you POSTed.
Struct {
success: bool,
}

Error Codes

錯誤說明
200Permissions error

正在刪除

You can delete a PageCallToAction by making a DELETE request to /{page_call_to_action_id}.

Requirements

TypeDescription

App Review

Your app must be be approved for the following login permissions and features.

Login permissions

pages_manage_cta

Features

None

Tokens

A Page access token for an admin of the Page

Permissions

pages_manage_cta

參數

這個端點沒有任何參數。

傳回類型

Struct {
success: bool,
}

Error Codes

錯誤說明
200Permissions error
210User not visible
100Invalid parameter