קוד המפתח הוא מחרוזת אלפאנומרית באורך 22 תווים שמאפשרת לאפליקציה להתחבר ל-Google Ads API. אחרי ש-Google תקצה לכם את האסימון, תוכלו להציג אותו או ליצור אסימון חדש בדף מרכז ה-API בחשבון הניהול ב-Google Ads.
לכל אסימון מפתח מוקצה רמת גישה, שמגדירה את מספר הקריאות ל-API שאפשר לבצע ביום באמצעות האסימון, וגם את הסביבה שבה אפשר לבצע את הקריאות.
כדי לבצע קריאות ל-API בחשבון הייצור, צריך לבקש גישה בסיסית או גישה רגילה לאסימון הפיתוח במהלך תהליך הבקשה לאסימון. רמות הגישה האלה לא נדרשות כדי לבצע קריאות לחשבונות בדיקה, כך שתוכלו להמשיך בתרגילים. עם זאת, מומלץ לקרוא את המאמר איך שולחים בקשה לגישה בסיסית אחרי שתסיימו את המדריך הזה.
צריך קוד מפתח חדש למפתחים?
כדאי להירשם לאסימון פיתוח חדש או לא, בהתאם לכמה גורמים. הנה כמה מהתרחישים הנפוצים:
תרחיש |
השלבים הבאים |
| החברה שלכם מעולם לא השתמשה ב-Google Ads API ואתם רוצים לפתח אפליקציות משלכם | נרשמים לקבלת קוד מפתח חדש. מידע נוסף |
| החברה שלכם משתמשת ב-Google Ads API באופן פעיל או השתמשה בו בעבר | בדרך כלל Google מעניקה אסימון מפתח אחד לכל חברה, כך שאם החברה שלכם כבר משתמשת ב-Google Ads API, תוכלו להשתמש שוב באסימון המפתח הקיים. מידע נוסף |
| החברה שלכם כבר משתמשת ב-Google Ads API, אבל היא גם מפתחת מוצר או כלי חדשים | אם אתם בטוחים שאתם לא יכולים להשתמש באסימון המפתח הקיים שלכם, תוכלו להגיש בקשה לאסימון חדש ולפרט את התרחיש לדוגמה בבקשה. בשאר המאמר תוכלו להשתמש באסימון המפתח הקיים שלכם. מידע נוסף |
| החברה שלכם משתמשת באפליקציה של צד שלישי | קוד מפתח נדרש רק אם אתם מפתחים אפליקציה משלכם. אם אתם משתמשים באפליקציה או בשירות של צד שלישי, מפתח האפליקציה צריך לקבל קוד מפתח לאפליקציה. אם אתם לא בטוחים לגבי המקרה שלכם, תוכלו לפנות לצוות התאימות ל-API. |
איך מגישים בקשה לקוד מפתח
יש שני שלבים בבקשה לקבלת קוד מפתח.
שלב 1: בוחרים או יוצרים חשבון ניהול ב-Google Ads
אם כבר יש לכם חשבון ניהול ב-Google Ads, תוכלו לבחור אותו בטופס הבקשה לקבלת האסימון. אם חשבון הניהול הזה עדיין לא מקושר לחשבונות האחרים שלכם, מומלץ למקם אותו בשורש היררכיית החשבונות כדי להקל על תהליך בדיקת האסימונים ולפשט את ניהול החשבון בהמשך.
אם אין לכם חשבון ניהול, תוכלו לפעול לפי ההוראות במרכז העזרה כדי ליצור חשבון כזה.
שלב 2: הגשת בקשה לקבלת גישה ל-Google Ads API
לתשומת ליבכם, תהליך הבדיקה של אסימון הפיתוח עשוי להימשך זמן מה. מידע נוסף
נכנסים לחשבון הניהול. אתם יכולים לבדוק אם זהו חשבון ניהול.
בסרגל החיפוש שבחלק העליון של הדף, מזינים 'מרכז ה-API' ובוחרים בו מהשלמת החיפוש. האפשרות מרכז ה-API מופיעה רק בחשבונות ניהול ב-Google Ads, ולא בחשבונות לקוח או בחשבונות ניהול לבדיקה.
ממלאים את טופס הגישה ל-API ומאשרים את התנאים וההגבלות.
מוודאים שהמידע נכון וכתובת ה-URL של אתר החברה תקינה. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה שלכם ותדחה אותה.
חשוב לוודא שכתובת האימייל ליצירת קשר עם ה-API שציינתם מובילה לתיבת דואר נכנס שנבדקת באופן קבוע. צוות התאימות ל-API של Google עשוי לפנות לכתובת האימייל הזו במהלך תהליך הבדיקה לצורך הבהרות. אם לא נצליח ליצור איתכם קשר, יכול להיות ש-Google לא תמשיך לטפל בבקשה.
אפשר לערוך את כתובת האימייל ליצירת קשר בנושא API במרכז ה-API. חשוב לעדכן את המידע הזה גם אחרי תהליך הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.
אחרי השלמת תהליך הבקשה, אסימון המפתח למפתחים יופיע במרכז ה-API עם הסטטוס Pending Approval (בהמתנה לאישור). קוד המפתח שלכם מוגדר עכשיו לרמה Test Access, ועכשיו אתם יכולים להתחיל לבצע קריאות ל-API בחשבונות בדיקה.
אחרי שתקבלו את אסימון המפתח, שימו לב לערך שלו כי תצטרכו אותו כשתבצעו את הקריאה הראשונה ל-API.
איך בודקים שאתם מחוברים לחשבון ניהול
כדי לגשת לקוד המפתח, צריך להיכנס לחשבון הניהול. חשבון הניהול לא יכול להיות חשבון ניהול לבדיקה.
כדי לוודא שאתם מחוברים לחשבון הניהול:
נכנסים לחשבון.
בצד ימין, בוחרים באפשרות ניהול. אם מופיעה הכיתוב הגדרות חשבון ניהול בפינה הימנית העליונה, סימן שאתם מחוברים לחשבון הניהול. אם מופיעה האפשרות Account settings (הגדרות החשבון), סימן שאתם מחוברים לחשבון לקוח.
אם הכיתוב חשבון לבדיקה מופיע באדום בפינה השמאלית העליונה, החשבון שלכם הוא חשבון ניהול לבדיקה או חשבון מפרסם לבדיקה.
איפה נמצא הטוקן של המפתח
אם יש לכם קוד מפתח, תוכלו למצוא אותו בדף מרכז ה-API בחשבון הניהול ב-Google Ads.
נכנסים לחשבון הניהול. אתם יכוליםלבדוק אם זהו חשבון ניהול.
בסרגל החיפוש שבחלק העליון של הדף, מקלידים 'מרכז ה-API' ובוחרים בו מהשלמת החיפוש. האפשרות מרכז ה-API מופיעה רק בחשבונות ניהול ב-Google Ads ולא בחשבונות ניהול לבדיקה.
אסימון המפתח ורמת הגישה שלו הם הערכים הראשונים שמופיעים בקטע API Access.