เริ่มต้นใช้งาน

คู่มือนี้จะอธิบายวิธีการเริ่มต้นรับข้อมูลจากกราฟสังคมของ Facebook

ก่อนเริ่มต้น

คุณจะต้องดำเนินการและมีสิ่งต่อไปนี้

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

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

ขั้นตอนที่ 1: เปิดเครื่องมือ Graph API Explorer

เปิด Graph API Explorer ในหน้าต่างเบราว์เซอร์ใหม่ เพื่อให้คุณสามารถลองดำเนินการตามตัวอย่างระหว่างที่อ่านบทแนะนำการใช้งานนี้ไปพร้อมกันได้

Explorer จะโหลดขึ้นมาพร้อมกับการสืบค้นเริ่มต้นที่มีเมธอด GET, API กราฟเวอร์ชั่นล่าสุด, โหนด /me ที่มีช่อง id และ name ในช่องสตริงการสืบค้น รวมถึงแอพ Facebook ของคุณ

ขั้นตอนที่ 2 สร้างโทเค็นการเข้าถึง

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

ขั้นตอนนี้เป็นผลิตภัณฑ์การเข้าสู่ระบบด้วย Facebook ของเราที่อนุญาตให้บุคคลเข้าสู่ระบบแอพโดยใช้ข้อมูลประจำตัว Facebook ของตน โดยการเข้าสู่ระบบด้วย Facebook จะช่วยให้แอพสามารถขอบุคคลหนึ่งในการเข้าถึงข้อมูล Facebook ของบุคคลนั้น และเพื่อให้บุคคลดังกล่าวยอมรับหรือปฏิเสธการเข้าถึงได้ ชื่อและรูปโปรไฟล์ของคุณจะเป็นสาธารณะ เพื่อให้ผู้คนสามารถค้นหาคุณได้บน Facebook ดังนั้นจึงไม่จำเป็นต้องเรียกใช้คำขอนี้เพิ่มเติม คลิกดำเนินการต่อในฐานะ... ระบบสร้างโทเค็นการเข้าถึงผู้ใช้ขึ้นแล้ว โทเค็นนี้มีข้อมูลต่างๆ เช่น แอพที่ส่งคำขอ บุคคลที่ใช้แอพเพื่อส่งคำขอ รวมถึงเวลาหมดอายุและขอบเขตของข้อมูลที่แอพสามารถส่งคำขอได้หากโทเค็นการเข้าถึงยังใช้งานได้อยู่ (โทเค็นจะหมดอายุในประมาณหนึ่งชั่วโมง) ในคำขอนี้ ขอบเขตคือ public_profile ซึ่งประกอบด้วยชื่อและรูปโปรไฟล์ของคุณ

คลิกไอคอนข้อมูลรูปวงกลมที่อยู่ถัดไปจากโทเค็นการเข้าถึงเพื่อดูข้อมูลของโทเค็น

ขั้นตอนที่ 3 ส่งคำขอ

คลิกปุ่มส่งที่มุมขวาบน

สิ่งที่คุณควรเห็น

คุณจะเห็นการตอบกลับ JSON พร้อม ID ผู้ใช้ Facebook และชื่อของคุณในหน้าต่างการตอบกลับ

หากคุณลบ ?fields=id,name ออกจากช่องสตริงการสืบค้นแล้วคลิกส่ง คุณจะได้ผลลัพธ์แบบเดียวกัน เนื่องจาก name และ id เป็นช่องโหนดผู้ใช้ที่ระบบส่งคืนตามค่าเริ่มต้น

การส่งคำขอครั้งที่สองของคุณ

ขั้นตอนที่ 1 มาเพิ่มช่องกัน

ลองเพิ่มความซับซ้อนของคำขอครั้งแรกขึ้นเล็กน้อยโดยเพิ่ม email อีกช่องหนึ่ง ซึ่งคุณสามารถเพิ่มช่องได้ในสองวิธีดังนี้

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

เพิ่มช่อง email แล้วคลิกส่ง

สิ่งที่คุณควรเห็น

เมื่อการเรียกไม่ล้มเหลว ระบบจะส่งคืนเฉพาะช่อง name และ id เท่านั้นพร้อมกับข้อความแก้ไขจุดบกพร่อง ให้คลิกลิงก์ (แสดง) เพื่อแก้ไขจุดบกพร่องของคำขอ

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

ขั้นตอนที่ 2 เพิ่มสิทธิ์การอนุญาต

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

ลิงก์ในการตอบกลับ

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

หมายเหตุ: บาง ID เป็นการผสมผสานกันระหว่าง ID หลักกับสตริง ID ใหม่ ตัวอย่างเช่น โพสต์ของผู้ใช้จะมี ID โพสต์ที่มีลักษณะดังนี้ 1028223264288_102224043055529 โดยที่ 1028223264288 เป็น ID ผู้ใช้

ลองดูที่จุดเชื่อมโยงกัน

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

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

รับโค้ดสำหรับคำขอของคุณ

เครื่องมือ Explorer ช่วยให้คุณทดสอบคำขอ และเมื่อได้รับการตอบกลับสำเร็จแล้ว คุณสามารถรับโค้ดเพื่อใส่ไว้ในโค้ดแอพของคุณได้ โดยให้คลิกรับโค้ดที่ด้านล่างของหน้าต่างการตอบกลับ Explorer จะรองรับโค้ด Android, iOS, JavaScript, PHP และ cURL ซึ่งโค้ดจะมีการเลือกไว้แล้วล่วงหน้า ดังนั้นคุณจึงแค่คัดลอกและวางได้เลย

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

เรียนรู้เพิ่มเติม

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