เวอร์ชันของ API กราฟ

โฮสต์ของลิงก์ที่ไปยังแอพ /app-link-host

อ็อบเจ็กต์โฮสต์ของลิงก์ที่ไปยังแอพแต่ละรายการสร้างขึ้นโดยแอพ โฮสต์ของลิงก์ที่ไปยังแอพคือตัวกำหนดขอบเขตสำหรับกลุ่มของลิงก์ที่ไปยังแอพต่างๆ

โปรดดูเอกสารประกอบหลักเกี่ยวกับลิงก์ที่ไปยังแอพของเราเพื่อเรียนรู้เพิ่มเติม

การอ่าน

GET /v21.0/{app-link-host-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(
    '/{app-link-host-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(
    "/{app-link-host-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-link-host-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:@"/{app-link-host-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

สิทธิ์การอนุญาต

  • ต้องใช้โทเค็นการเข้าถึงที่ถูกต้องอันใดอันหนึ่ง

การตอบกลับ

ชื่อ คำอธิบาย ประเภท

name

ชื่อที่กำหนดเองสำหรับโฮสต์ของลิงก์ที่ไปยังแอพนี้

string

canonical_url

URL ของลิงก์ที่ไปยังแอพ

string

การเผยแพร่

แอพต่างๆ สามารถสร้างโฮสต์ของลิงก์ที่ไปยังแอพโดยใช้จุดเชื่อมโยง /app/app_link_hosts

การลบ

แอพ Facebook สามารถลบลิงก์ที่ไปยังแอพโดยใช้จุดเชื่อมโยงนี้ได้ดังนี้

DELETE /v21.0/{app-link-host-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(
    '/{app-link-host-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 */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-link-host-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:@"/{app-link-host-id}"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

สิทธิ์การอนุญาต

  • ต้องใช้โทเค็นการเข้าถึงแอพเพื่อลบโฮสต์ของลิงก์ที่ไปยังแอพซึ่งเป็นของแอพนั้นๆ

การตอบกลับ

ส่งคืน true สำเร็จ หากไม่เป็นอย่างนั้น ข้อความแสดงข้อผิดพลาดจะปรากฏ

การอัพเดต

แอพ Facebook สามารถอัพเดตลิงก์ที่ไปยังแอพโดยใช้จุดเชื่อมโยงนี้ได้ดังนี้

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{app-link-host-id}',
    array (
      'name' => 'Updated Name',
      'android' => '[]',
      'web' => '{"should_fallback": true}',
    ),
    '{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 */
POST /v21.0/{app-link-host-id} HTTP/1.1
Host: graph.facebook.com

name=Updated+Name&android=%5B%5D&web=%7B%22should_fallback%22%3A+true%7D
Bundle params = new Bundle();
params.putString("name", "Updated Name");
params.putString("android", "[]");
params.putString("web", "{\"should_fallback\": true}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{app-link-host-id}",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
NSDictionary *params = @{
  @"name": @"Updated Name",
  @"android": @"[]",
  @"web": @"{\"should_fallback\": true}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{app-link-host-id}"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

สิทธิ์การอนุญาต

  • ต้องใช้โทเค็นการเข้าถึงแอพเพื่ออัพเดตโฮสต์ของลิงก์ที่ไปยังแอพซึ่งเป็นของแอพนั้นๆ

ช่อง

ชื่อ คำอธิบาย ประเภท

name

ชื่อที่กำหนดเองสำหรับโฮสต์ของลิงก์ที่ไปยังแอพนี้

string

การตอบกลับ

ส่งคืน true สำเร็จ หากไม่เป็นอย่างนั้น ข้อความแสดงข้อผิดพลาดจะปรากฏ