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

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

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

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

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

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

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

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

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

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

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

เปิดใช้ไลบรารี

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

  1. ไปที่ Google Cloud Console
  2. ตรวจสอบว่าคุณเลือกโปรเจ็กต์ที่ถูกต้องในเมนูแบบเลื่อนลงในแถบเมนูด้านบน
  3. เปิดใช้ API การแชร์แพ็กเกจอินเทอร์เน็ตมือถือในไลบรารี API
  4. เปิดใช้ Preprod Mobile Data Plan Shared 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 Groups) เพื่อเป็นเจ้าของโปรเจ็กต์ได้