הגדרת גישה ל-API

חשבון משתמש

כדי לבצע אימות באמצעות פרטי כניסה של חשבון משתמש:

1. קובעים את ההגדרות של פלטפורמת האימות של Google בפרויקט.

   1. פותחים את הדף Branding במסוף Google Cloud.

   2. בוחרים את הפרויקט הרצוי.

   3. ממלאים את הטופס ולוחצים על יצירה.

2. מכיוון שה-API של המרכז לניהול נתונים משתמש בהיקפי הרשאות רגישים, צריך לבצע את השלבים הבאים:

   1. עוברים להגדרות גישה לנתונים של הפרויקט.

   2. לוחצים על הוספה או הסרה של היקפי הרשאות.

   3. ברשימת ההיקפים, מחפשים את Data Manager API ומסמנים את התיבה של כל היקף שהאפליקציה דורשת:

      • ‫.../auth/datamanager: בוחרים בהיקף הזה לפעולות API רגילות, כמו ניהול נתוני לקוחות, קהלים ואירועים. זהו ההיקף העיקרי שמשמש לאורך המדריך הזה.

      • .../auth/datamanager.partnerlink: בחרו בהיקף הזה רק אם אתם שותפי נתונים שיוצרים או מוחקים קישורים של שותפים בחשבונות של מפרסמים.

   4. לוחצים על עדכון.

   5. לוחצים על שמירה.

   6. עוברים אל Audience במסוף Google Cloud ומגדירים את ההגדרות לפיתוח הראשוני:

      • מגדירים את סטטוס הפרסום לבדיקה.
      • מגדירים את User type ל-Internal (אם הפרויקט הוא בארגון ב-Google Workspace) או ל-External (אם הוא לא).
      • אם משתמשים ב-External, מוסיפים את חשבונות Google שמשמשים ליצירת פרטי כניסה בתור Test users.

      מידע נוסף על ההגדרות האלה זמין במאמר ניהול קהל היעד של האפליקציה.

3. לוחצים על Create OAuth2 client (יצירת לקוח OAuth2) כדי ליצור לקוח OAuth2 בפרויקט, או פועלים לפי ההוראות ליצירת לקוח OAuth2 למחשב. אם כבר יש לכם לקוח OAuth2 מסוג Desktop שאתם רוצים להשתמש בו ב-Data Manager API, אתם יכולים לדלג על השלב הזה.

   אם לוחצים על Create OAuth2 client, בוחרים באפשרות אפליקציה למחשב כשמופיעה ההודעה Configure your OAuth client, כדי שתוכלו להשתמש בלקוח OAuth בשלבים הבאים.

   יצירת לקוח OAuth2

   בשלב האחרון, לוחצים על DOWNLOAD CLIENT CONFIGURATION ובוחרים את מיקום ההורדה.

4. מריצים את הפקודה הבאה כדי ליצור קובץ ADC מקומי. הפקודה הזו מפעילה תהליך אינטרנטי שבו מוצגת בקשה להתחבר לחשבון Google שבו אתם משתמשים עם ה-API.

   מחליפים את PATH_TO_CLIENT_JSON בשם של קובץ ה-JSON שהורדתם.

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   אם רוצים להשתמש באותם פרטי כניסה ל-Data Manager API ול-Google Ads API, צריך לכלול את היקף ההרשאות של Google Ads API ברשימה --scopes:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   אם אתם רוצים להשתמש באותם פרטי כניסה ל-Data Manager API ול-Display & Video 360 API, צריך לכלול את ההיקף של Display & Video 360 API ברשימה --scopes:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

5. מריצים את הפקודה הבאה כדי לוודא שפרטי הכניסה מוגדרים בצורה נכונה. אם הפעולה בוצעה ללא שגיאות, הפקודה תדפיס אסימון גישה למסוף.

   gcloud auth application-default print-access-token
   

חשבון שירות

כדי ליצור חשבון שירות ולהשתמש בהתחזות לחשבון שירות לצורך אימות בסביבת פיתוח מקומית, פועלים לפי השלבים הבאים. בשלבים האלה משתמשים בהתחזות במקום במפתחות של חשבונות שירות, כי מפתחות של חשבונות שירות יכולים להפוך לסיכון אבטחה אם לא מנהלים אותם בקפידה.

1. לוחצים על הלחצן Create service account או פועלים לפי ההוראות כדי לבחור או ליצור חשבון שירות.

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

2. נותנים לחשבון השירות את תפקיד צרכן השימוש בשירות ב-IAM ‏(roles/serviceusage.serviceUsageConsumer), שכולל את ההרשאה serviceusage.services.use שמאפשרת לחשבון השירות לשלוח בקשות API לפרויקט.

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

3. נותנים לחשבון Google את תפקיד ה-IAM יצירת אסימונים בחשבון שירות (roles/iam.serviceAccountTokenCreator) בחשבון השירות.

   gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
     --member="user:USER_EMAIL" \
     --role="roles/iam.serviceAccountTokenCreator"
   

4. מריצים את הפקודה הבאה כדי להגדיר את ה-ADC:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
   

   אם אתם רוצים להשתמש באותם פרטי כניסה ל-Data Manager API ול-Google Ads API, צריך לכלול את ההיקף של Google Ads API ברשימה --scopes:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
   

   אם רוצים להשתמש באותם פרטי כניסה ל-Data Manager API ול-Display & Video 360 API, צריך לכלול את היקף ההרשאות של Display & Video 360 API ברשימה --scopes:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"
   

   כשמוצגת בקשה להיכנס לחשבון, נכנסים באמצעות חשבון Google שהוקצה לו התפקיד 'יצירת אסימונים בחשבון שירות'.

5. כדי לוודא שפרטי הכניסה הוגדרו בצורה נכונה, משתמשים בפקודה הבאה. אם הפעולה בוצעה ללא שגיאות, הפקודה תדפיס אסימון גישה למסוף.

   gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
   

חשבון משתמש

בוחרים את הכרטיסייה שמתאימה לתרחיש לדוגמה שלכם.

• בוחרים באפשרות מפרסם אם משתמשים בפרטי כניסה של חשבון Google שמוגדר כמשתמש בחשבונות המפרסמים שרוצים לנהל.
• בוחרים באפשרות שותף נתונים אם משתמשים בפרטי כניסה של חשבון Google שמוגדר כמשתמש בחשבון של שותף נתונים, ורוצים לנהל חשבונות של מפרסמים שיש להם קישור שותף לחשבון של שותף הנתונים. חשבונות של שותפי נתונים מונפקים רק אחרי שהם עוברים את תהליך האישור. כדי להתחיל, ממלאים את טופס ההתעניינות.

חשבון שירות

בוחרים את הכרטיסייה שמתאימה לתרחיש לדוגמה שלכם.

• בוחרים באפשרות מפרסם אם משתמשים בפרטי כניסה של חשבון Google שמוגדר כמשתמש בחשבונות המפרסמים שרוצים לנהל.
• בוחרים באפשרות שותף נתונים אם משתמשים בפרטי כניסה של חשבון Google שמוגדר כמשתמש בחשבון של שותף נתונים, ורוצים לנהל חשבונות של מפרסמים שיש להם קישור שותף לחשבון של שותף הנתונים. חשבונות של שותפי נתונים מונפקים רק אחרי שהם עוברים את תהליך האישור. כדי להתחיל, ממלאים את טופס ההתעניינות.