คู่มือ Graph API Explorer

การใช้งานทั่วไป

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

ข้อกำหนด

• บัญชีผู้พัฒนาสำหรับ Facebook
• แอพที่คุณมีบทบาท เช่น บทบาทผู้ดูแล ผู้พัฒนา หรือผู้ทดสอบ

ส่วนประกอบ

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

เมื่อคุณได้รับโทเค็นการเข้าถึง โทเค็นจะปรากฏที่ด้านขวาบนของเครื่องมือ ซึ่งเป็นโทเค็นที่จะรวมไว้ในการสืบค้น API กราฟของคุณ คุณสามารถคัดลอกโทเค็นนี้และใช้ในแอพเพื่อทดสอบโค้ดได้

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

คุณสามารถสร้างโทเค็นการเข้าถึงใหม่ได้หากโทเค็นหมดอายุหรือหากคุณเพิ่มสิทธิ์การอนุญาตใหม่

แอพ Meta

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

ผู้ใช้หรือเพจ

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

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

เมื่อใดก็ตามที่คุณส่งคำขอโทเค็นการเข้าถึงของผู้ใช้ จะมีเพียง public_profile ที่ได้รับสิทธิ์การอนุญาตโดยค่าเริ่มต้น เมนูดร็อปดาวน์สิทธิ์การอนุญาตช่วยให้คุณเลือกสิทธิ์การอนุญาตของข้อมูลผู้ใช้ เช่น สิทธิ์การอนุญาต email และ user_photos สิทธิ์การอนุญาตของงานกิจกรรม กลุ่ม และเพจ เช่น manage_pages และ ads_management และสิทธิ์การอนุญาตอื่นๆ เช่น สิทธิ์การอนุญาต instagram_basic และ publish_video ทำให้ผู้ใช้แอพในปัจจุบัน (ซึ่งหมายถึงคุณ) สามารถให้สิทธิ์การอนุญาตเฉพาะแอพได้ คุณจะให้สิทธิ์การอนุญาตเฉพาะแอพที่ต้องการจริงๆ เท่านั้น

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

ช่องสตริงการสืบค้น

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

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

ตัวดูช่องโหนด

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

หน้าต่างการตอบกลับ

การตอบกลับที่อยู่ด้านล่างของสตริงการสืบค้นจะแสดงผลลัพธ์ที่ส่งคืนมาจากการสืบค้นที่คุณส่งล่าสุด

รับโค้ด

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

คัดลอกข้อมูลการแก้ไขจุดบกพร่อง

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

บันทึกช่วงเวลาที่ใช้งาน

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

ตัวอย่างการสืบค้น

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

การสืบค้นเริ่มต้นจะปรากฏในช่องสตริงการสืบค้นต่อไปนี้:

GET https://developers.facebook.com/v21.0/me?fields=id,name

การสืบค้นเริ่มต้นกำลังส่งคำขอช่อง id และ name ในโหนด /me ซึ่งเป็นโหนดพิเศษที่แมปกับโหนด /User หรือ /Page ที่ระบุโดยโทเค็น เนื่องจากคุณกำลังใช้โทเค็นการเข้าถึงของผู้ใช้ ขั้นตอนนี้จะแมปคุณกับโหนดผู้ใช้ของคุณ

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

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