คู่มือการผสานรวม

รับคีย์ส่วนตัว

การใช้อินเทอร์เฟซการเริ่มต้นใช้งาน

หากต้องการผสานรวมกับ API คุณต้องสร้างโปรเจ็กต์ Google Cloud หลังจากนั้น ให้สร้างบัญชีบริการและรับคีย์ส่วนตัว คลิกปุ่มต่อไปนี้เพื่อเริ่มต้นใช้งาน

สร้างบัญชีบริการ

การสร้างคีย์ด้วยตนเอง

หากอินเทอร์เฟซข้างต้นใช้งานไม่ได้ โปรดลองทำดังนี้

  1. ไปที่ Google Cloud Console
  2. เลือกโปรเจ็กต์ที่จะใช้เข้าถึง API
  3. ในเมนู IAM และผู้ดูแลระบบทางด้านซ้าย ให้ค้นหาบัญชีบริการและสร้างบัญชีบริการใหม่ซึ่งจะเป็นเจ้าของโปรเจ็กต์
  4. เมื่อสร้างบัญชีบริการแล้ว คุณควรได้รับคีย์ส่วนตัว

บัญชีบริการที่อนุญาตพิเศษ

เมื่อสร้างบัญชีบริการแล้ว ให้ทำดังนี้

  1. โปรดติดต่อทีม GTAF ที่ mdp-support@google.com ด้วยบัญชี Google ซึ่งเป็นเจ้าของโปรเจ็กต์ เราจะเพิ่มบัญชี Google ลงในรายการที่อนุญาตเพื่อ เข้าถึงปลายทางของ Mobile Data Plan Sharing API
  2. เชื่อมโยงบัญชีบริการกับผู้ให้บริการในพอร์ทัล Google ISP ผู้ให้บริการสามารถทำการเชื่อมโยงนี้ได้โดยไปที่การเข้าถึง API

เปิดใช้คลัง

เมื่อดำเนินการเพิ่มในรายการที่อนุญาตแล้ว ให้ทำดังนี้

  1. ไปที่คอนโซล Google Cloud
  2. ตรวจสอบว่าคุณได้เลือกโปรเจ็กต์ที่ถูกต้องในเมนูแบบเลื่อนลงบนแถบเมนูด้านบน
  3. เปิดใช้ Mobile Data Plan Sharing API ในคลัง API
  4. เปิดใช้ Preprod Mobile Data Plan Sharing API ในคลัง API

ทดสอบการเข้าถึง API

วิธีทดสอบการเข้าถึงเมธอดฝั่ง Google

  1. ติดตั้ง oauth2l

  2. รับโทเค็นเพื่อการเข้าถึงสำหรับบัญชีบริการของคุณดังนี้ your-service-account-key-file.json คือไฟล์คีย์ของบัญชีบริการ

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    โปรดทราบว่าโทเค็นเพื่อการเข้าถึงจะหมดอายุในอีกประมาณ 1 ชั่วโมง ก่อนที่จะเรียกใช้คำสั่งด้านบนอีกครั้งเพื่อรับโทเค็นเพื่อการเข้าถึงใหม่ ให้เรียกใช้ oauth2l reset เพื่อล้างแคชในเครื่อง

  3. โทรทดสอบปัญหาดังนี้ YOUR-ASN ต้องเป็น ASN รายการใดรายการหนึ่งที่คุณส่ง ให้เราเมื่อเรากำหนดค่า GTAF ในระหว่างกระบวนการผสานรวม ACCESS-TOKEN-OBTAINED คือเอาต์พุตของคำสั่ง oauth2l fetch ด้านบน PLAN_STATUS คือข้อความคำขอในส่วนเนื้อหาของPlanStatus ที่คุณต้องการส่งไปยัง GTAF

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

การเรียก API แบบเป็นโปรแกรม

ทำตามวิธีการ เพื่อทำการเรียกที่ได้รับอนุญาตไปยังเมธอดฝั่ง Google โดยใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/dataplansharing

การแชร์ความเป็นเจ้าของโปรเจ็กต์

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