สร้าง เรียกดู และอัพเดตผู้ใช้ระบบ

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

สร้าง

ใช้โทเค็นผู้ใช้ระบบที่เป็นผู้ดูแลหรือโทเค็นการเข้าถึงของผู้ใช้ที่เป็นผู้ดูแลของคุณเองเพื่อสร้างผู้ใช้ระบบ

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

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

สร้างผู้ใช้ระบบที่เป็นผู้ดูแลและสร้างโทเค็น

  1. สร้างผู้ใช้ระบบที่เป็นผู้ดูแลด้วยโทเค็นการเข้าถึงผู้ใช้ที่เป็นผู้ดูแลของคุณเอง
  2. ติดตั้งแอพที่มีผู้ใช้ระบบที่เป็นผู้ดูแลโดยใช้โทเค็นการเข้าถึงของผู้ใช้ที่เป็นผู้ดูแล
  3. สร้างโทเค็นผู้ใช้ระบบที่เป็นผู้ดูแลโดยใช้โทเค็นการเข้าถึงของผู้ใช้ที่เป็นผู้ดูแล

สร้างผู้ใช้ระบบ

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

สร้างโทเค็นการเข้าถึงของผู้ใช้ระบบ

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

หากต้องการสร้างผู้ใช้ระบบหรือผู้ใช้ระบบที่เป็นผู้ดูแลผ่าน API คุณต้องมีสิ่งต่อไปนี้

  • โทเค็นการเข้าถึงของผู้ใช้ที่เป็นผู้ดูแลหรือผู้ใช้ระบบที่เป็นผู้ดูแลสำหรับตัวจัดการธุรกิจนี้
  • บทบาท ADMIN หรือ EMPLOYEE
  • ชื่อ: ตัวระบุของผู้ใช้ระบบนี้หรือผู้ใช้ระบบที่เป็นผู้ดูแล

หากต้องการสร้างผู้ใช้ระบบ ให้ส่งคำขอ POST:

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

การดำเนินการนี้จะส่งคืน id ในแอพของผู้ใช้ระบบใหม่:

{
  "id" : "100000008899900"
}

นี่คือ ID ในแอพสำหรับผู้ใช้ระบบ ซึ่งคุณควรใช้เพื่อเรียกใช้ API ไม่ใช่ Canonical ID ใน Business Manager > System Users

เรียกดู

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

ส่งคำขอ GET:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

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

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

อัพเดต

คุณสามารถเปลี่ยนชื่อของผู้ใช้ระบบหรือผู้ใช้ระบบที่เป็นผู้ดูแลได้

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

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

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

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

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