קוד מפתח

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

מה משתנה?

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

רמות הגישה ל-API משויכות לפרויקטים ב-Google Cloud

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

תהליך הרשמה חדש ל-Google Ads API

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

ממשק חדש לניהול הרשאות הגישה ל-API

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

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

קודי שגיאה חדשים

בגרסה 25 ואילך, Google Ads API מחזיר שגיאת AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION אם מנסים להשתמש בפרויקט בענן ב-Google Cloud עם גישת בדיקה כדי לבצע קריאות לחשבון פעיל. בגרסאות API ישנות יותר (גרסה 24 וגרסאות קודמות) מוצגת במקום זאת השגיאה AuthorizationError.ACTION_NOT_PERMITTED. אם השגיאה הזו מופיעה, צריך לעבור אל דף הסקירה הכללית של Google Ads API בפרויקט Google Cloud ולהגיש בקשה לגישה ל-Explorer.

נדרש אימות מותג כדי לקבל גישה בסיסית והרשאת גישה רגילה

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

הבקשות לגישה בסיסית הן אוטומטיות, והן ייבדקו תוך דקות לאחר אימות המותג והשליחה.

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

כתובות אימייל חדשות ליצירת קשר בנושא API

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

מה מפתחים קיימים צריכים לעשות

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

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

תיקון קוד האפליקציה: מומלץ לעדכן את האפליקציה כך שתפסיק לשלוח קוד מפתח כחלק מהקריאות ל-API. פרסמנו גרסאות מעודכנות של ספריות הלקוח, של שרת ה-MCP של Google Ads ושל Google Ads API Developer Assistant, שמאפשרות לבצע קריאות ל-API בלי להגדיר אסימון פיתוח. בגרסה ראשית עתידית של Google Ads API, נתחיל לדחות קודי מפתח בקריאות ל-API. אם האפליקציה שלכם משתמשת בספריות האלה, אתם צריכים לעדכן את יחסי התלות של האפליקציה כדי להשתמש בגרסה העדכנית.

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

בעיות מוכרות

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

המשתמשים לא מקבלים גישה ברמת Explorer או גישה בסיסית גם אחרי שהם משלימים את אימות המותג

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

שורש הבעיה

יכול להיות שהפרויקט שלכם ב-Google Cloud נכלל בתוכנית הניסיון בחינם של Google Cloud, או שיש לו חשבון לחיוב שהושעה או הושבת.

איך מבצעים אימות

בודקים את סטטוס החיוב ב-Google Cloud. אם הפרויקט לחיוב מופיע כ-"Free trial account" או שהוא מושעה או מושבת, הבעיה הזו משפיעה עליכם.

סטטוס

זיהינו את שורש הבעיה ואנחנו עובדים על פתרון.

פתרון עקיף זמני

יש כמה דרכים לפתור את הבעיה הזו. בוחרים את האפשרות שהכי מתאימה לתרחיש השימוש.

שדרוג פרויקט בענן ב-Google Cloud לתוכנית בתשלום

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

הסרת החיוב מפרויקט הענן שלך ב-Google Cloud

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

שימוש בפרויקט אחר ב-Google Cloud

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

פרויקטים עם רמות גישה Basic או Explorer שאושרו לאחרונה מקבלים את השגיאה AUTHORIZATION_ERROR

אנחנו מודעים לבעיה שבה חלק מהמשתמשים ששדרגו את רמת הגישה של הפרויקט שלהם ב-Google Cloud לרמות הגישה הבסיסית או הגישה המורחבת שאושרו אחרי 9 בספטמבר 2026, מקבלים את השגיאה AUTHORIZATION_ERROR כשהם מבצעים קריאות ל-Google Ads API בחשבונות בסביבת הייצור.

שורש הבעיה

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

איך מבצעים אימות

הבעיה הזו משפיעה עליכם אם כל התנאים הבאים מתקיימים:

  1. יש לכם אסימון פיתוח עם רמת גישה לבדיקה.
  2. השתמשתם בפרויקט בענן ב-Google Cloud ובקוד המפתח כדי לשלוח קריאות ל-Google Ads API לפני 9 בספטמבר 2026.
  3. שדרגתם את רמת הגישה של הפרויקט ב-Google Cloud לגישת Explorer, לגישה בסיסית או לגישה רגילה אחרי 9 בספטמבר 2026.
  4. הקריאות ל-API בחשבון ייצור נכשלות עם השגיאה AUTHORIZATION_ERROR. קריאות ל-API לחשבונות בדיקה מתבצעות בהצלחה.

סטטוס

יש לנו פתרון לבעיה הזו ואנחנו פועלים כדי להשיק אותו בשרתים שלנו. אחרי שהתיקון יופעל, הקריאות ל-API יחזרו לפעול.

פתרון עקיף זמני

אתם יכולים להשתמש בפרויקט חדש ב-Google Cloud כדי לבקש גישה ל-Explorer.

שאלות נפוצות

בקטע הבא מפורטות תשובות לשאלות נפוצות לגבי הוצאת אסימון הפיתוח משימוש ורמות הגישה ל-API.

מה קורה לרמות הגישה ל-API?

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

איך זוהו הפרויקטים להעברת רמות הגישה ל-API?

אם כבר היה לכם אסימון פיתוח מאושר לפני 9 בספטמבר 2026, רמות הגישה שלו הועברו לפרויקטים שלכם ב-Google Cloud באופן הבא:

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

האם אוכל להחזיק בכמה פרויקטים בענן עם רמות גישה שונות אחרי השינוי הזה?

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

דוגמה

לדוגמה, נניח שיש לכם 4 אסימוני פיתוח ו-6 פרויקטים בענן עם הפרטים הבאים:

  • קוד מפתח 1: abcdefghijkl1234567890 יש הרשאת גישה רגילה. הוא שימש עם מזהי הפרויקטים: 1234567890, ‏ 5678912345, ‏ 45678912345.
  • טוקן למפתחים 2: xyzabcdefghi6789012345 יש גישה בסיסית. הוא שימש עם מזהי הפרויקטים: 1231235678.
  • קוד מפתח 3: asdfgflkjhjz7654321012 עם גישה בסיסית, אבל אף פעם לא נעשה בו שימוש כדי לבצע קריאה ל-API. הוא אושר ב-90 הימים שלפני 9 בספטמבר 2026.
  • אסימון מפתח 4: qwertypoiuyu6543298790 היה עם הרשאת גישה רגילה, אבל לא נעשה בו שימוש ב-90 הימים האחרונים. מזהה הפרויקט 9876564900 שימש עם אסימון הפיתוח הזה לפני יותר מ-90 יום.
  • פרויקט בענן: מזהה הפרויקט בענן 7171234567 מעולם לא שימש עם אף אחד מקודי המפתחים כדי לבצע קריאה ל-API.

רמות הגישה ל-API יועברו מקודי המפתח לפרויקטים ב-Google Cloud באופן הבא:

קוד מפתח מזהה פרויקט רמת גישה הסבר
abcdefghijkl1234567890 1234567890 הרשאת גישה רגילה טוקן המפתח ומזהה הפרויקט משויכים זה לזה.
abcdefghijkl1234567890 5678912345 הרשאת גישה רגילה טוקן המפתח ומזהה הפרויקט משויכים זה לזה.
abcdefghijkl1234567890 45678912345 הרשאת גישה רגילה טוקן המפתח ומזהה הפרויקט משויכים זה לזה.
xyzabcdefghi6789012345 1231235678 גישה בסיסית קוד המפתח ומזהה הפרויקט משויכים זה לזה.
asdfgflkjhjz7654321012 -- -- הגישה ל-API של אסימון המפתח לא הועברה לאף פרויקט, כי אף פעם לא נעשה בו שימוש כדי לבצע קריאה ל-API.
qwertypoiuyu6543298790 9876564900 בדיקת גישה הגישה ל-API של טוקן הפיתוח בוטלה בגלל חוסר פעילות במשך 90 יום. רמת הגישה ל-API של הפרויקט מוגדרת כברירת מחדל כגישת בדיקה.
-- 7171234567 בדיקת גישה זה פרויקט חדש שלא השתמשתם בו עם אף אסימון פיתוח. רמת הגישה ל-API של הפרויקט מוגדרת כברירת מחדל לגישת בדיקה.

יש לי יותר מקוד מפתח אחד שאושר. לאיזה פרויקט תרצו להעביר את רמות הגישה ל-API?

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

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

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

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

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

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

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

איפה אפשר לראות את רמות הגישה ל-API של הפרויקט?

אפשר לראות את רמת הגישה ל-API של הפרויקט ב-Google Cloud בדף הסקירה הכללית של Google Ads API.

איך מבקשים רמות גישה גבוהות יותר ל-API?

אפשר להגיש בקשה לרמות גישה גבוהות יותר ל-API בפרויקט ב-Google Cloud דרך דף הסקירה הכללית של Google Ads API.

מה קורה לבקשה שלי לגישה ל-API שנמצאת בהמתנה?

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

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

האם אפשר לשייך מחדש את אסימון המפתח שאושר לפרויקט חדש ב-Google Cloud?

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

יש לי אסימון פיתוח מאושר, אבל אף פעם לא השתמשתי בו. אפשר להשתמש בטוקן המפתח הזה?

לא, אי אפשר להשתמש בטוקן המפתח הזה. יש שתי אפשרויות:

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

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

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

האם אפשר להפסיק לשלוח קודי מפתח כחלק מבקשות ה-API?

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

השתתפתי בתוכנית הפיילוט של רמת הגישה המנוהלת בענן. איך זה משפיע עליי?

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

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

אסימון המפתח שלי היה חלק מרשימת היתרים. איך זה משפיע עליי?

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

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

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

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

אסימון הפיתוח שלי דלף לגורם חיצוני. האם צריך לאפס את אסימון הפיתוח?

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

מה יקרה ל-API Center?

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

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

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

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

אני מפתח/ת חדש/ה. איך נרשמים ל-Google Ads API?

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

אילו הרשאות IAM נדרשות כדי לנהל רמות גישה ל-API?

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

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