התכונה הזו מאפשרת לכם לנהל את רמות הגישה ל-API באמצעות ארגון ב-Google Cloud, ומספקת לכם את היתרונות הבאים:
אין יותר צורך לשמור על אסימוני מפתחים: הגישה ל-API מנוהלת דרך הארגון ב-Google Cloud, כך שאין יותר צורך לדאוג לשמירה על אסימוני מפתחים או לדליפה שלהם. אפשר לא לשלוח את קוד המפתח בקריאות ל-API, אבל עדיין צריך לשלוח אסימון גישה.
מומלץ לשמור על פרויקטים נפרדים ב-Google API Console לאפליקציות שונות: כל פרויקט שמקושר לארגון ב-Google Cloud מקבל בירושה את רמת הגישה ל-API של הארגון. כך תוכלו ליצור כמה פרויקטים ב-Google API Console במסגרת הארגון הזה למטרות שונות, כמו ניהול מפורט של פרויקטים, פרויקטים נפרדים לאפליקציות שונות וכמה פרויקטים ב-Google API Console לחברי הצוות.
מעקב וניהול מדויקים יותר של המכסות: אתם יכולים לעקוב אחרי השימוש בממשקי ה-API בפרויקטים נפרדים או להגביל את השימוש בממשקי ה-API.
דרישות מוקדמות
קוד מפתח מאושר
כדי להשתמש באפשרות הזו, צריך להיות לכם כבר טוקן מאושר למפתחים. אפשר למצוא קוד מפתח קיים במרכז ה-API בחשבון הניהול שלכם ב-Google Ads. נכנסים לחשבון ואז עוברים אל 'אדמין' > 'מרכז ה-API'. במרכז ה-API, עוברים אל API Access > Developer token (גישת API > קוד מפתח).
ארגון ב-Google Cloud
קוד המפתח שלכם משויך ל-Google Ads API בארגון Google Cloud, ומשמש לקביעת רמות הגישה ל-API. יש כמה דרכים ליצור ארגון ב-Google Cloud.
תרחיש שלבים אתם לקוחות קיימים של Google Workspace או של Google Cloud Identity סביר להניח שכבר יש לכם משאב מסוג 'ארגון'. אפשר לבדוק וליצור חשבון אם צריך. אתם לא משתמשים ב-Google Workspace או ב-Google Cloud Identity נרשמים למהדורה חינמית של Google Cloud Identity. לאחר מכן יוצרים משאב מסוג Organization. אף אחת מהאפשרויות הקודמות לא מתאימה לך כשנרשמים לתוכנית הפיילוט, צריך להסביר את התרחיש ולבקש מ-Google ליצור בשבילכם משאב ארגון. Google תהיה הבעלים של משאב הארגון הזה ותנהל אותו ללא תשלום. הכנת הפרויקטים ב-Google API Console לתוכנית הפיילוט
כדי להשתתף בתוכנית הפיילוט, צריך להכין את הפרויקטים ב-Google API Console שבהם אתם משתמשים עם Google Ads API באופן הבא:
תרחיש שלבים כבר יש לכם ארגון ב-Google Cloud או שיצרתם אחד בשלב הקודם מוודאים שכל הפרויקטים ב-Google API Console שבהם הפעלתם את Google Ads API נמצאים בארגון הזה. אם היא לא בנכס שבבעלותכם, צריך להעביר אותה לארגון. אם אתם לקוחות קיימים של Google Workspace או של Google Cloud Identity, סביר להניח שהפרויקטים ב-Google API Console כבר נמצאים בארגון שלכם, ולכן תוכלו לדלג על השלב הזה.
אין לכם ארגון ב-Google Cloud ולא הצלחתם ליצור אחד בשלב הקודם חשוב לוודא שאתם משתמשים עם הרשאת אדמין בחשבון הניהול שלכם ב-Google Ads API ובפרויקט שלכם ב-Google API Console. ההרשאה הזו נדרשת כדי לבצע שלבים נוספים אחרי שהבקשה להצטרפות לתוכנית הפיילוט תאושר. כתובת אימייל עדכנית ליצירת קשר בנושא API
חשוב לוודא שכתובת האימייל ליצירת קשר בנושא Google Ads API מעודכנת. פרטי איש הקשר בנושא API מופיעים בדף API Center בחשבון הניהול שלכם ב-Google Ads API. נכנסים לחשבון ואז עוברים אל כלים והגדרות > הגדרה > מרכז ה-API.
הרשמה לתוכנית הפיילוט
הרשמה לתוכנית הפיילוט. צוות התאימות של Google יבדוק את הבקשה וישלח אימייל לכתובת האימייל של איש הקשר בנושא API עם סטטוס האישור ופרטים נוספים.
אם ביקשתם מ-Google ליצור בשבילכם ארגון ב-Google Cloud, יש כמה שלבים נוספים שצריך לבצע:
Google תיצור בשבילכם משאב ארגון ב-Cloud בבעלות Google. כל האדמינים בחשבון הניהול שלכם ב-Google Ads API יקבלו את התפקיד
roles/resourcemanager.projectCreatorבארגון החדש שנוצר.Google תשלח אימייל לכתובת האימייל של איש הקשר בנושא API עם הפרטים של מקור הארגון החדש שנוצר.
צריך להיכנס לחשבון Google API Console ולפעול לפי ההוראות כדי להעביר את הפרויקט ב-Google API Console לארגון החדש.
משיבים לאימייל כדי לעדכן את Google שהפרויקטים שלכם הועברו לארגון החדש.
צוות התאימות של 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/v20/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"שאלות נפוצות
ריכזנו כאן כמה שאלות נפוצות לגבי רמות גישה שמנוהלות ב-Cloud.
האם השינוי הזה אומר שאני צריך להיות לקוח של Google Workspace או Google Cloud כדי להשתמש ב-Google Ads API?
לא. אתם צריכים ארגון ב-Google Cloud. יש כמה דרכים להשיג אותו. הדרישה הזו דומה לדרישה הקיימת כיום לשימוש ב-Google Ads API, שלפיה צריך פרויקט ב-Google API Console.
אני רוצה לשנות את רמות הגישה שלי ל-API. איך אפשר לעשות את זה?
בינתיים, צריך להמשיך להשתמש במרכז ה-API כדי לבקש שינויים ברמות הגישה ל-API.
האם יש זמן השבתה כשמצטרפים לפיילוט הזה?
לא, אין. אחרי האישור, מערכת Google Ads API תתחיל להשתמש באופן אוטומטי ברמות הגישה ל-API ברמת הארגון.
כמה מאמץ נדרש כדי להשתתף בפיילוט הזה?
צפויים שינויים מינימליים בקוד. רוב המפתחים יוכלו לבצע את השינויים באפליקציה שלהם תוך פחות מ-30 דקות.
האם אחויב אם אצטרף לתוכנית הפיילוט הזו?
באופן כללי, לא, לא נחייב אתכם אם תצטרפו לפיילוט הזה. Google Ads API מוצע ללא תשלום, ו-Google לא מבצעת שינויים במודל התמחור של Google Ads API.
אלה התרחישים האפשריים לקבלת ארגון ב-Google Cloud:
אתם לקוחות קיימים של Google Workspace או Google Cloud Identity:
תחויבו כרגיל על כל שימוש רגיל במוצרים האלה. לא תחויבו על יצירת ארגון ב-Google Cloud לצורך השתתפות בתוכנית הפיילוט הזו.
יצרתם חשבון במהדורה החינמית של Google Cloud Identity:
לא תחויבו כשתיצרו חשבון ב-Google Cloud Identity במהדורה החינמית או כשתיצרו ארגון ב-Google Cloud כדי להשתתף בתוכנית הפיילוט הזו.
Google יצרה בשבילכם משאב ארגון ב-Cloud:
זהו משאב Organization פנימי ב-Cloud שמנוהל על ידי Google, ולכן לא תחויבו עליו.
יש לי כמה אסימוני מפתח לכלים שונים. איך תוכנית הפיילוט הזו משפיעה עליי?
מקרה השימוש הזה לא נתמך, ולכן לא תוכלו להשתתף בתוכנית הפיילוט הזו.
האם זה משפיע על הרשאת API קיימת לחשבונות שאני מנהל באמצעות Google Ads API?
לא, השינוי הזה לא משפיע על הרשאות קיימות ל-API בחשבונות Google Ads שאתם מנהלים באמצעות Google Ads API.
הצטרפתי לפיילוט הזה ויש לי בעיה או משוב. איך פונים לתמיכה?
פונים לצוות Google Ads API באמצעות דף התמיכה הטכנית ב-API ומסבירים את מהות הבעיה. אם אפשר, כדאי לכלול פרטים כמו מזהה הארגון, יומני בקשות ותגובות.