קוד המפתח הוא מחרוזת אלפאנומרית באורך 22 תווים שמאפשרת לאפליקציה שלכם להתחבר ל-Google Ads API. אפשר לקבל אותו על ידי הרשמה במרכז ה-API בחשבון הניהול ב-Google Ads. בכל פעם שאתם מבצעים קריאה ל-API, אתם שולחים את קוד המפתח כחלק מהבקשה על ידי הגדרת הכותרת developer-token http או gRPC.
לכל קוד מפתח מוקצית רמת גישה שקובעת את מספר הקריאות ל-API שאפשר לבצע ביום באמצעות הקוד, וגם את הסביבה שאליה אפשר לשלוח קריאות.
כשנרשמים לקבלת קוד מפתח, יכול להיות שתקבלו כברירת מחדל רמת גישה ל-Explorer. כך תוכלו לבצע קריאות לחשבונות פעילים, אבל עם מגבלות מסוימות. במקרים מסוימים שבהם אנחנו לא יכולים לבדוק את הבקשה שלך לקוד מפתח באופן אוטומטי, יכול להיות שנעניק לקוד המפתח שלך רמת גישה של חשבון בדיקה במקום זאת. כך תוכלו לבצע קריאות ל-API רק בחשבונות בדיקה. כדי להסיר את ההגבלות של רמות הגישה 'חשבון בדיקה' ו'חשבון עם גישה מוגבלת', צריך לבקש רמת גישה בסיסית או רגילה עבור קוד המפתח. אחרי שנבדוק ונאשר את הבקשה שלכם לקוד מפתח, לקוד המפתח שלכם תוקצה רמת הגישה המתאימה.
צריך קוד מפתח חדש?
ההחלטה אם להירשם לקוד מפתח חדש תלויה בכמה גורמים. הנה כמה מהתרחישים הנפוצים:
תרחיש |
השלבים הבאים |
| החברה שלך מעולם לא השתמשה ב-Google Ads API ואתה רוצה לפתח אפליקציות משלך | נרשמים לקוד מפתח חדש. מידע נוסף |
| החברה שלך משתמשת באופן פעיל ב-Google Ads API או השתמשה בו בעבר | בדרך כלל Google מעניקה קוד מפתח אחד לכל חברה, לכן אם החברה שלכם כבר משתמשת ב-Google Ads API, כדאי להשתמש מחדש בקוד המפתח הקיים. מידע נוסף |
| החברה שלכם כבר משתמשת ב-Google Ads API, אבל היא גם מפתחת מוצר או כלי חדשים | אם אתם בטוחים שאי אפשר להשתמש בקוד מפתח הקיים, אתם יכולים להגיש בקשה לקוד מפתח חדש ולפרט בבקשה את תרחיש השימוש. בשאר המדריך הזה, אפשר להשתמש באסימון הקיים למפתחים. מידע נוסף |
| החברה שלכם משתמשת באפליקציה של צד שלישי | אתם צריכים קוד מפתח רק אם אתם מפתחים אפליקציה משלכם. אם אתם משתמשים באפליקציה או בשירות של צד שלישי, המפתח של האפליקציה הזו צריך לקבל קוד מפתח בשביל האפליקציה. אם אתם לא בטוחים מה המצב שלכם, אתם יכולים לפנות לצוות התאימות ל-API. |
מי יכול להגיש בקשה לקוד מפתח?
גם חברות וגם מפתחים פרטיים יכולים להגיש בקשה לקוד מפתח. בטבלה הבאה מפורטים הפרטים שצריך לספק כשנרשמים לקבלת קוד מפתח.
| אם אתם | לאחר מכן, צריך לספק את פרטי המפתח הבאים | הערות נוספות |
|---|---|---|
| מפתח שמייצג את החברה שלכם או צוות מוצר | שם החברה וכתובת האתר של החברה | בדרך כלל Google מעניקה קוד מפתח אחד לכל חברה, אבל היא מאשרת קודי מפתח נפרדים לכלים נפרדים על בסיס כל מקרה לגופו. |
| מפתח יחיד שלא מייצג חברה | מציינים את שם החברה בתור Individual. אתם יכולים לספק כתובות URL חלופיות, כמו כתובת ה-URL של פרופיל GitHub או כתובת ה-URL של פרופיל LinkedIn, במקום כתובת URL של חברה. |
אתם צריכים להיות בעלי נוכחות כלשהי באינטרנט, ועליכם לספק ל-Google כתובת URL
שתעזור לנו להעריך מה אתם מתכננים לעשות עם Google Ads API. כתובות URL כלליות
כמו test.com ו-example.com לא מתקבלות. |
איך מגישים בקשה לקוד מפתח
תהליך הגשת הבקשה לקוד מפתח כולל שני שלבים.
שלב 1: בוחרים או יוצרים חשבון ניהול ב-Google Ads
אם כבר יש לכם חשבון ניהול ב-Google Ads, אתם יכולים לבחור אותו כשאתם שולחים בקשה לקבלת קוד מפתח. אם חשבון הניהול הזה עדיין לא מקושר לחשבונות האחרים שלכם, מומלץ למקם אותו בבסיס היררכיית החשבונות כדי להקל על תהליך הבדיקה של האסימון ולפשט את ניהול החשבון בהמשך.
אם אין לכם חשבון ניהול, תוכלו לפעול לפי ההוראות במרכז העזרה כדי ליצור חשבון כזה.
שלב 2: שולחים בקשה לגישה אל Google Ads API
הערה: תהליך הבדיקה של קוד המפתח עשוי להימשך זמן מה. מידע נוסף
בדפדפן האינטרנט, עוברים אל https://ads.google.com/aw/apicenter. אם מופיעה בקשה, נכנסים לחשבון הניהול ב-Google Ads.
ממלאים את הטופס של גישה ל-API ומאשרים את התנאים וההגבלות.
חשוב לוודא שהפרטים נכונים וכתובת האתר של החברה פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה שלכם ותדחה אותה.
חשוב לוודא שכתובת האימייל ליצירת קשר בנושא API שסיפקתם מובילה לתיבת דואר נכנס שנבדקת באופן קבוע. צוות התאימות ל-API של Google עשוי לפנות לכתובת האימייל הזו במהלך תהליך הבדיקה כדי לקבל הבהרות. אם לא נוכל ליצור איתך קשר, יכול להיות ש-Google לא תמשיך בתהליך הבקשה.
אפשר לערוך את כתובת האימייל של איש הקשר בנושא API במרכז ה-API. חשוב לשמור את הפרטים האלה עדכניים, גם אחרי תהליך הגשת הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.
אחרי שמסיימים את תהליך הבקשה, קוד המפתח מופיע במרכז ה-API עם אחת מהתוצאות הבאות:
- קוד המפתח שלך הוא ברמת Explorer Access עם סטטוס Approved. המשמעות היא ש-Google הצליחה לבדוק ולאשר באופן אוטומטי את הבקשה שלך לקוד מפתח ברמת גישה של Explorer. אפשר להתחיל לבצע קריאות ל-API בחשבון הפעיל או בחשבון הבדיקה.
- רמת הגישה של קוד המפתח שלך היא גישה לחשבון בדיקה והסטטוס שלו הוא בהמתנה לאישור. כלומר, Google לא הצליחה לבדוק ולאשר באופן אוטומטי את הבקשה שלך לקבלת קוד מפתח ברמת גישה Explorer. אפשר להתחיל לבצע קריאות ל-API מול חשבונות בדיקה. אחרי שתסיימו לקרוא את המדריך הזה, מומלץ לעיין במאמר איך שולחים בקשה לרמת גישה בסיסית.
איך בודקים אם אתם מחוברים לחשבון ניהול ב-Google Ads
כדי לגשת לקוד המפתח, צריך להיכנס לחשבון הניהול ב-Google Ads. אי אפשר להשתמש בחשבון ניהול לבדיקה ב-Google Ads.
כדי לבדוק אם אתם מחוברים לחשבון הניהול ב-Google Ads:
בדפדפן האינטרנט, עוברים אל https://ads.google.com/aw/apicenter.
אם אתם מחוברים לחשבון לקוח, בדף יופיע הכיתוב מרכז ה-API זמין רק לחשבונות ניהול.
אם Test account (חשבון בדיקה) מופיע באדום בפינה השמאלית העליונה, החשבון שלכם הוא חשבון בדיקה לניהול או חשבון בדיקה לפרסום.
איפה אפשר למצוא את קוד המפתח
אם יש לכם קוד מפתח, הוא מופיע בדף המרכז ל-API בחשבון הניהול שלכם ב-Google Ads.