קוד המפתח הוא מחרוזת אלפאנומרית באורך 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
לתשומת ליבך, תהליך הבדיקה של אסימון המפתח עשוי להימשך זמן מה. מידע נוסף
בדפדפן האינטרנט, עוברים אל https://ads.google.com/aw/apicenter. אם מופיעה בקשה, נכנסים לחשבון הניהול ב-Google Ads.
ממלאים את הטופס של גישה ל-API ומאשרים את התנאים וההגבלות.
חשוב לוודא שהמידע נכון ושהכתובת של אתר החברה פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה שלכם ותדחה אותה.
חשוב לוודא שכתובת האימייל ליצירת קשר בנושא API שציינתם מובילה לתיבת דואר נכנס שנבדקת באופן קבוע. צוות התאימות של Google ל-API עשוי ליצור קשר עם כתובת האימייל הזו במהלך תהליך הבדיקה כדי לקבל הבהרות. אם לא נוכל ליצור איתך קשר, יכול להיות ש-Google לא תמשיך בתהליך הבקשה.
אפשר לערוך את כתובת האימייל של איש הקשר בנושא API במרכז ה-API. חשוב לשמור את המידע הזה מעודכן, גם אחרי תהליך הגשת הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.
אחרי שמסיימים את תהליך הגשת הבקשה, קוד המפתח מופיע במרכז ה-API עם הסטטוס Pending Approval (בהמתנה לאישור). קוד המפתח שלך קיבל עכשיו רמה של גישה לחשבון בדיקה, ואפשר להתחיל לבצע קריאות ל-API מול חשבונות בדיקה.
אחרי שמקבלים את קוד המפתח, חשוב לשים לב לערך שלו כי תצטרכו אותו כשתיצרו את קריאת ה-API הראשונה.
איך בודקים אם מחוברים לחשבון ניהול
כדי לגשת לקוד המפתח, צריך להיכנס לחשבון הניהול. אי אפשר להשתמש בחשבון ניהול לצורך בדיקה.
כדי לבדוק אם אתם מחוברים לחשבון הניהול:
בדפדפן האינטרנט, עוברים אל https://ads.google.com/aw/apicenter.
אם אתם מחוברים לחשבון לקוח, בדף יופיע הכיתוב מרכז ה-API זמין רק לחשבונות ניהול.
אם Test account (חשבון בדיקה) מופיע באדום בפינה השמאלית העליונה, החשבון שלכם הוא חשבון בדיקה לניהול או חשבון בדיקה לפרסום.
איפה אפשר למצוא את טוקן המפתח
אם יש לכם קוד מפתח, הוא מופיע בדף המרכז ל-API בחשבון הניהול שלכם ב-Google Ads.