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

URL /?id={url}

แสดงถึง URL ที่แชร์ในโพสต์หรือในความคิดเห็นต่อโพสต์

โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบเกี่ยวกับ API การจัดทำดัชนีในแท็บข่าวของเรา

การอ่าน

รับข้อมูลเกี่ยวกับ URL ที่แชร์ในโพสต์หรือในความคิดเห็นต่อโพสต์

ข้อกำหนด

ประเภทคำอธิบาย
โทเค็นการเข้าถึง

สามารถนำโทเค็นการเข้าถึงมาใช้เพื่อส่งคำขอนี้ได้

ฟีเจอร์

ไม่สามารถใช้งานได้

งานบนเพจ

ไม่สามารถใช้งานได้

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

ไม่สามารถใช้งานได้

ข้อจำกัด

  • ค่าการมีส่วนร่วมที่ระบบส่งคืนมานั้นไม่แม่นยำ แต่แสดงถึงการมีส่วนร่วมของผู้ใช้กับ URL
  • ระบบจะจำกัดให้คุณส่งคำขอ GET ได้ 10 รายการ ต่อ URL ต่อแอพ ต่อชั่วโมง

พารามิเตอร์

เพิ่มพารามิเตอร์สตริงการสืบค้นต่อไปนี้เพื่อเสริมคำขอ

พารามิเตอร์คำอธิบาย

access_token

ต้องระบุ

สตริง

โทเค็นการเข้าถึง

fields

สตริง

รายการช่องต่างๆ ที่คุณต้องการส่งคำขอ โดยคั่นด้วยเครื่องหมายจุลภาค

id

สตริง

URL ที่จะแชร์

scopes

สตริง

รายการขอบเขตโดยคั่นด้วยเครื่องหมายจุลภาค

ช่อง

ชื่อคุณสมบัติ คำอธิบาย ประเภท
app_links

ข้อมูล AppLinks ที่เชื่อมโยงกับ URL นี้ (หากมี)

AppLinks

id

URL ในตัว

string

engagement

จำนวนวิธีต่างๆ ที่ผู้คนใช้โต้ตอบกับ URL ดังกล่าว ทั้งนี้ โปรดทราบว่าเราตั้งใจทำให้ค่าการมีส่วนร่วมไม่แม่นยำ แต่คุณสามารถมั่นใจได้ว่าค่าเหล่านี้แสดงถึงการมีส่วนร่วมของผู้ใช้ต่อ URL ได้อย่างถูกต้อง

object

comment_count

จำนวนความคิดเห็นบน URL

int

comment_plugin_count

จำนวนความคิดเห็นบนปลั๊กอินที่รวบรวมมาโดยใช้ปลั๊กอินความคิดเห็นบนเว็บไซต์ของคุณ

int

reaction_count

จำนวนการตอบสนองต่อ URL

int

share_count

จำนวนครั้งที่มีการแชร์ URL

int

og_object

อ็อบเจ็กต์ Open Graph ที่เชื่อมโยงกับ URL นี้ในลักษณะตามที่ได้บัญญัติไว้

OGObject

id

ID อ็อบเจ็กต์

string

description

คำอธิบายอ็อบเจ็กต์ ถ้ามี

string

title

ชื่ออ็อบเจ็กต์ ถ้ามี

string

type

ประเภทอ็อบเจ็กต์

og:type

updated_time

เมื่ออัพเดตอ็อบเจ็กต์ล่าสุด

datetime

ตัวอย่าง

หากต้องการรับข้อมูลเกี่ยวกับ URL ที่เผยแพร่ในโพสต์หรือความคิดเห็น ให้ส่งคำขอ GET ไปยัง https://graph.facebook.com พร้อมพารามิเตอร์ id ที่ตั้งค่าเป็น URL, ช่องใดก็ตามที่เกี่ยวกับ URL นั้น และโทเค็นการเข้าถึงที่ร้องขอจากผู้ใช้หรือเพจที่เผยแพร่โพสต์หรือความคิดเห็นดังกล่าว

ตัวอย่างต่อไปนี้จะแสดงการมีส่วนร่วมสำหรับ URL https://www.facebook.com ซึ่งมีการแชร์โดยผู้ใช้ผ่านโทเค็นการเข้าถึงผู้ใช้

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับจำนวนการมีส่วนร่วมดังต่อไปนี้สำหรับ URL ที่มีการแชร์

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

การสร้าง

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

การอัพเดต

อัพเดต URL

ข้อกำหนด

ประเภทคำอธิบาย
โทเค็นการเข้าถึง

สามารถนำโทเค็นการเข้าถึงมาใช้เพื่อส่งคำขอนี้ได้

ฟีเจอร์

ไม่สามารถใช้งานได้

งานบนเพจ

ไม่สามารถใช้งานได้

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

ไม่สามารถใช้งานได้

ตัวอย่าง

หากต้องการอัพเดตข้อมูลเกี่ยวกับ URL ที่เผยแพร่ในโพสต์หรือความคิดเห็น ให้ส่งคำขอ POST ไปยัง https://graph.facebook.com พร้อมพารามิเตอร์ id ที่ตั้งค่าเป็น URL, พารามิเตอร์ scrape ที่ตั้งค่าเป็น true, fields ใดก็ตามที่เกี่ยวกับ URL นั้น และโทเค็นการเข้าถึงที่ร้องขอจากผู้ใช้หรือเพจที่เผยแพร่โพสต์หรือความคิดเห็นดังกล่าว

ตัวอย่างต่อไปนี้จะเป็นการอัพเดต URL https://www.facebook.com/my-update ซึ่งมีการแชร์โดยผู้ใช้ผ่านโทเค็นการเข้าถึงผู้ใช้

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับจำนวนการมีส่วนร่วมดังต่อไปนี้สำหรับ URL ที่มีการแชร์

{
  "success": true
}  

พารามิเตอร์สตริงการสืบค้น

เพิ่มพารามิเตอร์สตริงการสืบค้นต่อไปนี้เพื่อเสริมคำขอ

พารามิเตอร์คำอธิบาย

access_token

ต้องระบุ

สตริง

โทเค็นการเข้าถึง

fields

สตริง

รายการช่องต่างๆ ที่คุณต้องการส่งคำขอ โดยคั่นด้วยเครื่องหมายจุลภาค

id

ต้องระบุ

สตริง

URL ที่จะอัพเดต URL จะต้องได้รับการเข้ารหัส เพื่อไม่ให้รบกวนพารามิเตอร์ scrape

scrape

ต้องระบุ

บูลีน

ค่าต้องเป็น true

ตัวอย่างคำขอ

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

ตัวอย่างการตอบกลับ

{
  "success": true
}

การลบ

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้