התנסות ב-Admin API

יש שתי אפשרויות לניסיון של Admin API:‏ OAuth 2.0 Playground או APIs Explorer.

OAuth 2.0 Playground

אפשר להשתמש ב-OAuth 2.0 Playground כדי לראות תצוגה מקדימה של תהליך אימות, לקבל אסימוני גישה וגם לשלוח בקשות HTTP. כדי להשתמש ב-OAuth 2.0 Playground:

  1. פותחים את OAuth 2.0 Playground.
  2. בשלב 1, היקף ההרשאות https://www.googleapis.com/auth/cloud-platform נבחר מראש. לוחצים על Authorize APIs כדי להתחיל את תהליך האימות.
  3. כדי להעניק גישה ל-Google Cloud services באמצעות OAuth 2.0 Playground של Google, לוחצים על Allow (אישור) כדי לפעול לפי 'תהליך האימות המרומז'.

  4. בשלב 2, לוחצים על Exchange authorization code for tokens כדי לקבל אסימון גישה.

  5. בשלב 3, השדה URI של בקשה מאוכלס מראש עם ה-URI לדוגמה:

    https://appengine.googleapis.com/v1/apps/{appsId}/services/default

    צריך להחליף את {appsId} במזהה הפרויקט ב-Google Cloud Platform ואז ללחוץ על Send the request כדי לראות את הפרטים על השירות default של הפרויקט.

    בשדה הזה של ה-URI אפשר לשלוח בקשות HTTP מול המשאבים שצוינו בפרויקט. למידע נוסף על ציון משאבים במזהי URI של בקשות, אפשר לעיין במאמר בנושא REST ב-Admin API.

APIs Explorer

אפשר להשתמש ב-APIs Explorer כדי לראות רשימה של כל השיטות והשדות של Admin API והתיאורים שלהם. אחר כך אפשר ללחוץ על הפריטים ברשימה כדי ליצור מזהי URI ולשלוח בקשות HTTP מול המשאבים שציינתם.

כדי להשתמש ב-APIs Explorer:

  1. פותחים את APIs Explorer.
  2. בוחרים את השיטה שרוצים לנסות.
  3. מציינים את מזהי המשאבים בפרויקט, וגם את השדות הנתמכים.
  4. לוחצים על Execute כדי לשלוח את בקשת ה-HTTP לפרויקט, ואז רואים את ה-URI של הבקשה שנוצרה ואת תגובת ה-HTTP.

המאמרים הבאים