הגדרה של Service Usage בסביבת פיתוח

בדף הזה מוסבר איך להגדיר את סביבת הפיתוח כך שתעבוד עם Service Usage API.

  • ברוב התרחישים האופרטיביים לדוגמה, הדרך הפשוטה ביותר להפעיל ולהשבית שירותים היא באמצעות מסוף Google Cloud .
  • אם אתם צריכים ליצור סקריפטים, אתם יכולים להשתמש ב-Google Cloud CLI.
  • אם אתם צריכים לכתוב קוד שמשתמש ב-Service Usage API, אפשר להשתמש באחת מספריות הלקוח.
  • כדי להתנסות ב-API בלי להגדיר סביבת פיתוח מלאה לאפליקציות, תוכלו לבצע את ההוראות החלופיות להגדרה שמפורטות במדריך הזה ולהשתמש בפקודה curl.

הגדרה לקריאה ישירה ל-API

בקטע הזה מתוארים השלבים הבסיסיים להגדרת הסביבה המקומית שלכם כדי להתנסות ב-Service Usage API באמצעות הפקודה curl. הממשק מיועד למפתחים שצריכים לכתוב קוד שמשתמש ב-Service Usage API.

הפעלת Service Usage API

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

  1. עוברים לדף API Library במסוף Google Cloud .
    כניסה לדף API Library
  2. בוחרים את Google Cloud הפרויקט שרוצים להשתמש בו כדי לגשת לשירות.
  3. בדף API Library (ספריית ה-API), לוחצים על Enable (הפעלה).
  4. מוודאים שלחשבון המשתמש שלכם יש את התפקיד Service Usage Admin (אדמין של שימוש בשירות).

בדיקה באמצעות curl

  1. מגדירים כינוי מעטפת נוח לקריאה לממשקי API ל-REST של Google:

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. מגדירים משתנה סביבה PROJECT_ID עם המזהה של הפרויקט. זה יכול להיות מזהה הפרויקט או מספר הפרויקט:

    PROJECT_ID="my-project-id"
    
  3. מוודאים שאתם מחוברים ל-gcloud:

    gcloud auth login
    
  4. הצגת רשימה של ממשקי ה-API והשירותים המופעלים בפרויקט הזה:

    gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_ID}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
    

    אם מופיע פלט כמו זה, סימן שההגדרה הושלמה בלי שגיאות:

    {
    "services": [
      {
        "config": {
          "name": "bigquery.googleapis.com",
          "title": "BigQuery API"
        }
      },
      {
        "config": {
          "name": "bigquerystorage.googleapis.com",
          "title": "BigQuery Storage API"
        }
      },
      ...
    

השלבים הבאים

פועלים לפי ההוראות שבקטע רישום שירותים כדי לרשום את ממשקי ה-API והשירותים שמופעלים או זמינים בפרויקטים שלכם ב- Google Cloud .