ภาพรวม API กราฟ

API กราฟคือวิธีขั้นต้นในการดึงข้อมูลและใส่ข้อมูลลงในแพลตฟอร์มของ Facebook ซึ่งเป็น API ที่อยู่บน HTTP ระดับล่างที่คุณสามารถใช้ในการสืบค้นข้อมูล โพสต์เรื่องราวใหม่ๆ จัดการโฆษณา อัพโหลดรูปภาพ และทำงานต่างๆ ที่แอพอาจจำเป็นต้องทำด้วยการตั้งโปรแกรม

ข้อมูลพื้นฐาน

API กราฟตั้งชื่อตามแนวคิดของ "กราฟโซเชียล" ซึ่งเป็นสิ่งที่แสดงแทนข้อมูลใน Facebook ซึ่งประกอบด้วย:

  • โหนด - "สิ่ง" พื้นฐานต่างๆ เช่น ผู้ใช้ รูปภาพ เพจ ความคิดเห็น
  • จุดเชื่อมโยง - ความเชื่อมโยงระหว่าง "สิ่งต่างๆ" เหล่านั้น เช่น รูปภาพของเพจ หรือความคิดเห็นของรูปภาพ
  • ช่อง - ข้อมูลเกี่ยวกับ "สิ่ง" เหล่านั้น เช่น วันเกิดของบุคคล หรือชื่อของเพจ

API กราฟทำงานอยู่บน HTTP ดังนั้นจึงใช้ได้กับภาษาใดๆ ที่มีไลบรารี HTTP เช่น cURL และ urllib เราจะอธิบายเกี่ยวกับสิ่งที่คุณสามารถดำเนินการได้ในส่วนข้างล่างนี้ แต่นั่นหมายความคุณยังสามารถที่จะใช้ API กราฟโดยตรงในเบราว์เซอร์ของคุณ ตัวอย่างเช่น คำขอ API กราฟ นั้นเทียบเท่ากับ:

GET graph.facebook.com
  /facebook/picture?
    redirect=false

คำขอ API กราฟส่วนใหญ่กำหนดให้มีการใช้โทเค็นการเข้าถึง ซึ่งแอพของคุณสามารถสร้างขึ้นโดยการนำการเข้าสู่ระบบด้วย Facebook ไปใช้

ข้อมูลภาพรวมนี้จะแสดงให้เห็นว่า API กราฟสามารถอ่านและเผยแพร่ข้อมูลไปยังกราฟโซเชียลได้อย่างไร

โครงสร้าง

เราได้อธิบายเกี่ยวกับโครงสร้างไว้อย่างละเอียดใน คำแนะนำการใช้ API กราฟ แต่โดยทั่วไปแล้ว คุณสามารถอ่าน API ได้ด้วยการสร้างคำขอ HTTP GET ไปยังโหนดหรือจุดเชื่อมโยงที่อยู่บนโหนดเหล่านั้น

เกือบทุกคำขอจะถูกส่งไปยัง API ที่ graph.facebook.com โดยมีข้อยกเว้นเดียวคือการอัพโหลดวิดีโอซึ่งใช้ graph-video.facebook.com

ID อ็อบเจ็กต์

แต่ละโหนดมี ID เฉพาะตัวซึ่งใช้ในการเข้าถึงตัวโหนดเองผ่าน API กราฟ เราไม่ได้จัดทำเอกสารเฉพาะสำหรับโครงสร้างโหนด/ ID อ็อบเจ็กต์เนื่องจากมีความเป็นไปได้อย่างยิ่งว่าจะมีการเปลี่ยนแปลงตลอดเวลาและแอพไม่ควรสร้างข้อสันนิษฐานโดยใช้โครงสร้างปัจจุบันเป็นเกณฑ์

ต่อไปนี้คือวิธีที่คุณอาจใช้ ID ในการสร้างคำขอสำหรับโหนด:

GET graph.facebook.com
  /{node-id}

หรือจุดเชื่อมโยง:

GET graph.facebook.com
  /{node-id}/{edge-name}

โดยทั่วไปแล้ว คุณสามารถเผยแพร่ไปยัง API ได้โดยสร้างคำขอ HTTP POST พร้อมพารามิเตอร์ไปยังโหนด:

POST graph.facebook.com
  /{node-id}

หรือจุดเชื่อมโยง:

POST graph.facebook.com
  /{node-id}/{edge-name}

การลบผ่าน API นั้นสามารถทำได้โดยการใช้คำขอ HTTP DELETE (และการอัพเดตผ่านคำขอ POST) ไปยังจุดสิ้นสุดเดียวกัน

เวอร์ชั่นของ API

API กราฟมีหลายเวอร์ชั่นที่พร้อมใช้สำหรับการเข้าถึงได้ ณ เวลาใดเวลาหนึ่ง แต่ละเวอร์ชั่นประกอบด้วยชุดของช่อง แกนหลัก และการดำเนินการของจุดเชื่อมโยง เรารับประกันว่า API แกนหลักเหล่านี้จะมีให้บริการและไม่มีการปรับเปลี่ยนในเวอร์ชั่นนั้นเป็นเวลา 2 ปีนับจากวันนำออกใช้ บันทึกการเปลี่ยนแปลงของแพลตฟอร์ม สามารถบอกได้ว่ามีเวอร์ชั่นใดให้บริการอยู่ในปัจจุบัน

การดำเนินการบางอย่าง เช่น การเผยแพร่ภายในจุดเชื่อมโยง หรือบางช่องภายในโหนดอาจเป็นแกนหลักโดยไม่มีจุดเชื่อมโยงหรือโหนดทั้งหมดเป็นแกนหลัก เราได้ให้คำจำกัดความประกอบ API หลักเหล่านี้โดยการใช้สัญลักษณ์ ภายใน เอกสารอ้างอิงสำหรับ API กราฟของเรา

ทุกสิ่งที่อยู่นอก API แกนหลักเหล่านี้เรียกว่า API ขยาย API เหล่านี้ยังคงเข้าถึงได้ผ่านเส้นทางที่ได้รับการกำหนดเวอร์ชั่น แต่มีโอกาสที่จะได้รับการปรับเปลี่ยนหรือลบออกได้ทุกเวลาและอาจมีการเปลี่ยนไปใช้เวอร์ชั่นใน 90 วัน ที่จะประกาศในแผนแม่บทสำหรับแพลตฟอร์มของเรา หรือในอีกทางหนึ่งคืออาจจะมีการรวมเข้าไปใน API เวอร์ชั่นถัดไปที่ให้บริการ

คุณสามารถอ่านเพิ่มเติมเกี่ยวกับจุดมุ่งหมายในการกำหนดเวอร์ชั่นในคำแนะนำของเราได้ แต่ในที่นี้เราจะอธิบายวิธีทำการเรียกไปยังบางเวอร์ชั่นของ API กราฟอย่างเจาะจง

ซึ่งเป็นสิ่งที่ทำได้ง่ายมาก เพียงพักตัวระบุเวอร์ชั่นไว้ก่อนที่จุดเริ่มของเส้นทางคำขอ ตัวอย่างเช่น นี่คือการเรียกไปยัง v2.2:

GET graph.facebook.com
  /v2.2/me

ซึ่งวิธีนี้จะใช้ได้กับทุกเวอร์ชั่น ในรูปแบบทั่วไป:

GET graph.facebook.com
  /vX.Y/{request-path}

ซึ่ง X.Y คือเวอร์ชั่นที่ต้องการ เราเผยแพร่รายการทั้งหมดของเวอร์ชั่นที่ให้บริการในบันทึกการเปลี่ยนแปลงของเราเอกสารอ้างอิงเกี่ยวกับ API กราฟทั้งหมดของเราให้ข้อมูลตามเวอร์ชั่น ดังนั้นโปรดตรวจสอบให้แน่ใจว่าคุณกำลังดูเวอร์ชั่นที่ถูกต้อง บางเวอร์ชั่นจะลบโหนดและจุดเชื่อมโยงออก บางเวอร์ชั่นจะเพิ่มโหนดและจุดเชื่อมโยง

ทีนี้มาลองสร้างคำขอ API เพื่อจะได้เห็นว่าสามารถทำได้ง่ายมาก

โหลด Graph API Explorer

วิธีที่ง่ายที่สุดในการทำความเข้าใจ API กราฟ คือการใช้งานด้วย Graph API Explorer เครื่องมือในระดับต่ำที่คุณสามารถใช้เพื่อสืบค้นข้อมูล เพิ่มและลบข้อมูล ซึ่งเป็นทรัพยากรที่มีประโยชน์ที่ควรมีไว้ใกล้ตัวในขณะที่คุณรวมเข้ากับ Facebook ดังนั้น ขั้นตอนต่อไปคือไปยัง Graph API Explorer

Graph API Explorer

สร้างโทเค็นการเข้าถึงสำหรับผู้ใช้พื้นฐาน

เมื่อคุณจะสร้างแอพของตัวเอง คุณจำเป็นต้องเรียนรู้เกี่ยวกับโทเค็นการเข้าถึงและวิธีการสร้างโดยการใช้การเข้าสู่ระบบด้วย Facebook แต่ขณะนี้ เราสามารถใช้โทเค็นตัวหนึ่งได้อย่างรวดเร็วผ่าน Graph API Explorer:

  1. คลิกที่ปุ่ม Get Token ที่ด้านขวาบนของ Explorer
  2. เลือกตัวเลือก Get User Access Token
  3. ในกล่องโต้ตอบต่อไปนี้ ไม่ต้องทำเครื่องหมายที่ช่องใดเลย เพียงคลิกที่ปุ่มสีฟ้า Get Access Token
  4. คุณจะเห็นกล่องโต้ตอบการเข้าสู่ระบบด้วย Facebook ให้คลิก OK เพื่อดำเนินการ

สร้างคำขอแรกของคุณ

ขณะนี้คุณพร้อมแล้วที่จะสร้างคำขอ API กราฟแรกของคุณ เราจะเริ่มด้วยคำขอ "อ่าน" ในช่องข้อความข้างปุ่มเลื่อนลง "GET" (เราจะเรียกสิ่งนี้ว่าช่องเส้นทาง) ให้ลบข้อความที่มีอยู่เดิมและพิมพ์คำว่า "me":

จากนั้นกดปุ่ม "ส่ง" การดำเนินการจะใช้เวลาสองถึงสามวินาที แต่คุณควรเห็นข้อมูลจำนวนมากปรากฏในแผงการตอบสนอง สิ่งที่ปรากฏที่นี่สำหรับคุณได้รับการตรวจสอบจากการตั้งค่าความเป็นส่วนตัวของโปรไฟล์ของคุณ แต่ควรมีช่องพื้นฐานอย่างน้อยจำนวนหนึ่ง ต่อไปนี้:

สิ่งที่คุณเพิ่งได้ทำที่นี่ใน Graph API Explorer นั้นเทียบเท่ากับคำขอ "อ่าน" ของ API กราฟ:

GET graph.facebook.com
  /me

/me คือปลายทางพิเศษที่แปลไปยัง ID ผู้ใช้ของผู้ที่เป็นเจ้าของโทเค็นการเข้าถึงที่กำลังใช้เพื่อสร้างคำขอ

ขอแสดงความยินดี คุณสร้าง API กราฟแรกของคุณสำเร็จแล้ว!

รับสิทธิ์การอนุญาตในการเผยแพร่

ต่อไปเราจะลองเผยแพร่บางสิ่งไปยัง Facebook โดยการใช้ API กราฟ คุณอาจดำเนินการขั้นตอนในนี้ภายในแอพของคุณเท่านั้นหากคุณกำลังสร้างตัวสร้างแบบกำหนดรูปแบบเองของคุณและไม่ได้ใช้หนึ่งในกล่องการแชร์ในเว็บไซต์, iOS หรือ Android กล่องการแชร์ของ Facebook ไม่ได้กำหนดให้คุณต้องผสานการเข้าสู่ระบบด้วย Facebook หรือสร้างอินเทอร์เฟซของคุณเองในการให้ผู้ใช้แชร์

ในการสำรวจการเผยแพร่ด้วย API กราฟ คลิกที่ปุ่ม "ขอรับโทเค็นการเข้าถึง" นั้นอีกครั้ง และครั้งนี้ ให้เลือกสิทธิ์การอนุญาต publish_actions:

แล้วคลิกที่ปุ่ม "ขอรับโทเค็นการเข้าถึง" สีฟ้าคุณจะเห็นกล่องการเข้าสู่ระบบอีกครั้ง ที่นี่ ระบบจะขอใช้สิทธิ์การอนุญาต Graph API Explorer เพื่อโพสต์ในนามของคุณ คุณสามารถเปลี่ยนกลุ่มเป้าหมายเป็น 'เฉพาะฉัน' ได้ที่นี่หากต้องการ เพื่อให้เฉพาะคุณเท่านั้นที่สามารถเห็นโพสต์ได้ แต่คุณควรยอมรับกล่องโต้ตอบนี้และดำเนินการในขั้นตอนต่อไป

เผยแพร่โพสต์

หากคุณได้ขอสิทธิ์การอนุญาต publish_actions ให้คลิกที่ปุ่มที่เขียนว่า "GET" แล้วเลือก "POST" จากตัวเลือกดรอปดาวน์ที่ปรากฏ ป้อน me/feed ในช่องเส้นทาง แล้วคลิก "เพิ่มช่อง"

ในช่องใหม่ที่ปรากฏ ใส่ message เป็น "ชื่อ"และ Hello, World เป็น "ค่า" ซึ่งควรมีลักษณะดังนี้:

ตอนนี้ให้คลิกที่ปุ่ม "ส่งข้อมูล" สีฟ้า และหลังจากสองถึงสามวินาที แผงการตอบสนองควรแสดงบางสิ่ง เช่น:

{
  "id": "{new-post-id}"
}

ซึ่งหมายถึงคุณเพิ่งเผยแพร่โพสต์แรกของคุณผ่าน API กราฟ! คุณสามารถไปที่โปรไฟล์ของคุณ และคุณควรเห็นโพสต์ที่นั่น:

สิ่งที่คุณเพิ่งได้ทำที่จุดนี้ใน Graph API Explorer นั้นเทียบเท่ากับคำขอ "เผยแพร่" ของ API กราฟ:

POST graph.facebook.com
  /me/feed?
    message="Hello, World."&
    access_token={your-access-token}

ขั้นตอนถัดไป

คุณได้รับทราบข้อมูลพื้นฐานแล้วในที่นี้ คุณน่าจะเรียนรู้เกี่ยวกับการใช้ API กราฟเพิ่มอีก หากคุณยังไม่ได้เริ่ม เราขอแนะนำให้คุณอ่านเกี่ยวกับการเข้าสู่ระบบด้วย Facebook ก่อนและโดยเฉพาะที่เกี่ยวกับวิธีสร้างโทเค็นการเข้าถึง ซึ่งคุณจะต้องสร้างคำขอ API ที่ซับซ้อนยิ่งขึ้น