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