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