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

חשבון משתמש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3. לוחצים על Create OAuth2 client כדי ליצור לקוח 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. מקצים לחשבון השירות את התפקיד Service Usage Consumer ב-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 שמוגדר כמשתמש בחשבון של שותף נתונים, ורוצים לנהל חשבונות של מפרסמים שיש להם קישור שותף לחשבון של שותף הנתונים. חשבונות של שותפי נתונים מונפקים רק אחרי שהם עוברים את תהליך האישור. כדי להתחיל, ממלאים את טופס ההתעניינות.