רמות גישה בניהול בענן

הערה: Google מקבלת מועמדים לתוכנית הזו. להרשמה.

התכונה הזו מאפשרת לנהל את רמות הגישה ל-API באמצעות Google Cloud Organization, כך שתוכלו ליהנות מהיתרונות הבאים:

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

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

• מעקב אחרי מכסות וניהול מכסות: אפשר לעקוב אחרי ה-API שימוש בפרויקטים נפרדים או מכסת השימוש ב-API.

דרישות מוקדמות

• קוד מפתח מאושר

  כדי להשתמש באפשרות הזו, כבר צריך להיות לך קוד מפתח מאושר. שלך יכול למצוא קוד מפתח קיים בדף מרכז API של חשבון ניהול ב-Google Ads. כניסה, ואז נכנסים אל כלים הגדרות > הגדרה > מרכז API.

• ארגון ב-Google Cloud

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

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

• הכנת הפרויקטים ב-Google API Console לתוכנית הפיילוט

  עליך להכין את הפרויקטים במסוף Google API שבהם השתמשת עם Google Ads API לתוכנית הפיילוט:

  תרחיש	שלבים
  כבר יש לכם ארגון ב-Google Cloud או שיצרתם ארגון כזה השלב הקודם	צריך לוודא שכל הפרויקטים ב-Google API Console שבהם הפעלתם את Google Ads API נכלל בארגון הזה. אם לא, מעבירים אותו בארגון. אם יש לכם חשבון Google Workspace או Google Cloud לקוח זהות, רוב הסיכויים שהפרויקטים במסוף Google API כבר בארגון שלך, לכן אפשר לדלג על השלב הזה.
  לא בבעלותך ארגון ב-Google Cloud ולא הייתה לך אפשרות ליצור ארגון ב- השלב הקודם	לוודא שאתם גם משתמשים עם הרשאת אדמין בחשבון הניהול ב-Google Ads API והפרויקט ב'מסוף Google API'. דרושה לך ההרשאה הזו כדי לבצע שלבים נוספים לאחר שבקשת הפיילוט שלכם תאושר.

• כתובת אימייל עדכנית ליצירת קשר עם ה-API

  צריך לוודא שכתובת האימייל ליצירת קשר ב-Google Ads API מעודכנת. איש הקשר שלך עבור ממשק ה-API הפרטים מופיעים בדף 'מרכז ה-API' של חשבון הניהול ב-Google Ads API. צריך להיכנס לחשבון ואז לנווט אל כלים ו- הגדרות > הגדרה > מרכז API.

הרשמה לתוכנית הפיילוט

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

אם ביקשת מ-Google ליצור בשבילך ארגון ב-Google Cloud, נדרשים כמה שלבים נוספים:

1. Google תיצור בשבילכם משאב ארגוני ב-Cloud שנמצא בבעלות Google. הכול האדמינים של חשבון הניהול שלך ב-Google Ads API יקבלו התפקיד roles/resourcemanager.projectCreator בחשבון החדש שנוצר של הארגון.

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

3. עליך להיכנס לחשבון שלך ב-Google API Console ולפעול בהתאם הוראות להעברת הפרויקט של 'מסוף Google API' אל בארגון החדש.

4. עונים לאימייל כדי להודיע ל-Google שהפרויקטים שלכם הועברו לארגון חדש.

5. צוות התאימות של Google יבדוק את הבקשה וישלח אימייל אל ה-API כתובת האימייל ליצירת קשר עם סטטוס האישור ופרטים נוספים.

שינוי בקשות ה-API

אפשר לשנות את האפליקציה כך שתפסיק לשלוח את הכותרת של developer-token כאשר ביצוע קריאות ל-API. השלב הזה הוא אופציונלי אבל מומלץ. אם אתם תוכנית הפיילוט, שרת Google Ads API מתעלם מהdeveloper-token אם הוא נשלח כחלק של בקשות ה-API.

Java

בקרוב!

‎.NET

מורידים ומתקינים את גרסה 17.1.0 ואילך של Google Ads API .NET לספרייה.

לאחר מכן, משנים את הקוד באופן הבא:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

בקרוב!

Python

בקרוב!

Ruby

בקרוב!

Perl

בקרוב!

לקוח HTTP (REST)

השמטת הכותרת developer-token בבקשות HTTP:

curl -i -X POST https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

שאלות נפוצות

האם המשמעות של השינוי הזה היא שצריך להיות לקוחות Google Workspace או Google Cloud כדי להשתמש ב-Google Ads API?

לא. נדרש ארגון ב-Google Cloud, שאפשר לקבל בהרבה קבוצות דרכים. הדרישה הזו דומה לזו שצריך פרויקט מסוף Google API לשימוש ב-Google Ads API עוד היום.

עליי לשנות את רמות הגישה שלי ל-API. איך אפשר לעשות את זה?

בינתיים עליך להמשיך להשתמש במרכז ה-API כדי לבקש שינויים רמות הגישה ל-API.

האם צריך זמן השבתה כדי להצטרף לפיילוט הזה?

לא. Google Ads API יתחיל באופן אוטומטי להשתמש ב- רמות הגישה ל-API ברמת הארגון לאחר האישור.

כמה מאמץ צריך להשקיע כדי להשתתף בתוכנית הפיילוט הזו?

צפויים שינויים מינימליים בקוד. לרוב המפתחים צריכה להיות יכולת להשלים שינויים באפליקציה תוך פחות מ-30 דקות.

האם אצטרך להצטרף לתוכנית הפיילוט הזאת?

באופן כללי, לא נחייב אתכם אם תצטרפו לתוכנית הפיילוט הזאת. Google Ads API מוצעת ללא תשלום, ו-Google לא מבצעת שינויים ב-Google Ads API מודל התמחור.

התרחישים האפשריים לקבלת ארגון ב-Google Cloud הם: ככה:

1. לקוחות קיימים של Google Workspace או Google Cloud Identity:

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

2. יצרתם חשבון במהדורת Google Cloud Identity בחינם:

   לא נחייב אותך במהלך ההרשמה למהדורה החינמית של Google Cloud Identity או לצורך יצירת ארגון ב-Google Cloud למטרות בתוכנית הפיילוט הזאת.

3. Google יצרה בשבילכם משאב ארגוני ב-Cloud:

   זהו משאב ארגון פנימי המנוהל על ידי Google ב-Cloud, לא יחויב כתוצאה מכך.

יש לי כמה אסימוני מפתח לכלים שונים. איך תוכנית הפיילוט הזו משפיעה עליי?

התרחיש לדוגמה הזה לא נתמך ולכן לא תהיה לך אפשרות להשתתף בו בתוכנית פיילוט.

האם השינוי ישפיע על הרשאות קיימות ב-API בחשבונות שמנוהלים על ידי Google Ads API?

לא, השינוי הזה לא ישפיע על הרשאות קיימות של API עבור Google Ads חשבונות שאתם מנהלים באמצעות Google Ads API.

הצטרפתי לפיילוט ויש לי בעיה או משוב. איך פונים לתמיכה?

פנייה לצוות Google Ads API באמצעות התמיכה הטכנית של API ולהסביר את אופי הבעיה. כלול כמו מזהה הארגון ויומני הבקשות והתגובות, ככל האפשר.