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