מדריך לשילוב

קבלת מפתח פרטי

שימוש בממשק ההצטרפות

כדי לשלב עם ה-API, צריך ליצור פרויקט ב-Google Cloud. לאחר מכן, צריך ליצור חשבון שירות ולקבל מפתח פרטי. כדי להתחיל, לחצו על הלחצן הבא:

ליצירת חשבון שירות

מפתח שנוצר באופן ידני

אם הממשק שלמעלה נכשל, אפשר לנסות את הפעולות הבאות:

  1. נכנסים ל-Google Cloud Console.
  2. בוחרים את הפרויקט שאליו רוצים לגשת ל-API.
  3. בתפריט IAM & מימין, מאתרים חשבונות שירות ויוצרים חשבון שירות חדש שיהיה הבעלים של הפרויקט.
  4. אחרי שחשבון השירות ייווצר, תקבלו מפתח פרטי.

הוספת חשבון שירות לרשימת ההיתרים

אחרי שיוצרים חשבון שירות:

  1. אפשר לפנות לצוות GTAF בכתובת mdp-support@google.com באמצעות חשבון Google שבבעלותו הפרויקט. אנחנו נוסיף את חשבון Google לרשימת ההיתרים כדי לגשת לנקודות הקצה של ה-API לשיתוף נתונים בנייד.
  2. משייכים את חשבון השירות לספק בפורטל ה-ISP של Google. הספק יכול לבצע את השיוך הזה על ידי מעבר אל גישה ל-API.

הפעלת הספרייה

לאחר השלמת רשימת ההיתרים:

  1. נכנסים ל-Google Cloud Console.
  2. מוודאים שבחרתם את הפרויקט הנכון בתפריט הנפתח בסרגל התפריטים העליון.
  3. מפעילים את Mobile Data Plan Sharing API בספריית ה-API.
  4. עליך להפעיל את Proprod 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

    התוקף של אסימון הגישה יפוג בעוד כשעה. לפני הרצת הפקודה שוב עבור אסימון גישה חדש, הריצו את 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"

קריאות ל-Programmatic API

יש לפעול לפי ההוראות כדי לבצע שיחות מורשות לשיטות של Google, עם היקף ה-OAuth הבא:

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

שיתוף הבעלות על הפרויקט

ההגדרה הראשונית כוללת חשבון Google יחיד, אבל כדאי לקבוצה של משתמשים מורשים להיות הבעלים של הפרויקט. ב-Google Cloud Console, בקטע 'מנהל מערכת ב-IAM &amp', אפשר להוסיף חברים חדשים (כולל חשבון קבוצות Google) כבעלים של הפרויקט.