אסימון המפתח הוא מחרוזת אלפאנומרית באורך 22 תווים שמאפשרת לאפליקציה להתחבר ל-Google Ads API. אחרי ש-Google הקצתה לכם את האסימון, תוכלו לצפות בו או ליצור אסימון חדש בדף API Center של חשבון הניהול ב-Google Ads.
לכל קוד מפתח מוקצית רמת גישה שקובעת את מספר הקריאות ל-API שאפשר לבצע ביום באמצעות האסימון, וגם את הסביבה שאליה אפשר לבצע קריאות.
כדי לשלוח קריאות ל-API בחשבון הייצור שלכם, אתם צריכים לבקש גישה בסיסית או הרשאת גישה רגילה לקוד המפתח בתהליך הבקשה לאסימון. מכיוון שרמות הגישה האלה לא נדרשות כדי לשלוח קריאות לחשבונות בדיקה, תוכלו להמשיך בתרגילים. כדאי לקרוא את המאמר איך מגישים בקשה לקבלת גישה בסיסית אחרי שתסיימו את המדריך הזה.
האם צריך קוד מפתח חדש?
ההחלטה אם להירשם לקוד מפתח חדש או לא תלויה בכמה גורמים. הנה כמה מהתרחישים הנפוצים:
תרחיש |
השלבים הבאים |
| החברה שלך לא השתמשה ב-Google Ads API בעבר וברצונך לפתח אפליקציות משלך | נרשמים לקוד מפתח חדש. מידע נוסף |
| החברה שלכם משתמשת ב-Google Ads API או השתמשה בו בעבר. | Google מעניקה בדרך כלל קוד מפתח אחד לכל חברה, כך שאם החברה שלך כבר משתמשת ב-Google Ads API, עליך לעשות שימוש חוזר בקוד המפתח הקיים. מידע נוסף |
| החברה שלך כבר משתמשת ב-Google Ads API, אבל היא גם מפתחת מוצר או כלי חדש | אם אין לך ספק שאין לך אפשרות להשתמש בקוד המפתח הקיים שלך, אפשר להגיש בקשה לקבלת קוד חדש שמסביר את התרחיש לדוגמה שלך באפליקציה. עד לסוף המדריך הזה תוכלו להשתמש בקוד המפתח הקיים שלכם. מידע נוסף |
| החברה שלך משתמשת באפליקציה של צד שלישי | נדרש קוד מפתח רק אם מפתחים אפליקציה משלך. אם בחרת אפליקציה או שירות של צד שלישי, מפתח האפליקציה צריך לקבל קוד מפתח לאפליקציה. אם לא ברור לך לגבי הפנייה, אפשר לפנות לצוות התאימות ל-API. |
איך מגישים בקשה לקוד מפתח
הגשת בקשה לקוד מפתח מתבצעת בשני שלבים.
שלב 1: בוחרים או יוצרים חשבון ניהול ב-Google Ads
אם כבר יש לכם חשבון ניהול ב-Google Ads, תצטרכו לבחור אותו כשאתם מגישים בקשה לאסימון. אם חשבון הניהול הזה עדיין לא מקושר לחשבונות האחרים שלכם, מומלץ לשים אותו ברמה הבסיסית (root) של היררכיית החשבון כדי להקל על תהליך הבדיקה של האסימון ולפשט את ניהול החשבון בהמשך.
אם אין לכם חשבון ניהול, אפשר ליצור חשבון כזה בעזרת ההוראות במרכז העזרה.
שלב 2: הגשת בקשה לקבלת גישה ל-Google Ads API
לתשומת ליבכם: תהליך הבדיקה של קוד המפתח עשוי להימשך זמן מה. מידע נוסף
נכנסים לחשבון הניהול ולוחצים על הלחצן חיפוש.
מקלידים "api center" ובוחרים אותו מתוך ההשלמה האוטומטית של החיפוש. האפשרות API Center מופיעה רק בחשבונות ניהול ב-Google Ads, ולא בחשבונות של מפרסמים או בחשבונות ניהול לבדיקה.
ממלאים את טופס הגישה ל-API ומאשרים את התנאים וההגבלות.
ודאו שהפרטים שלכם נכונים ושכתובת האתר של החברה שלכם פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה ולדחות אותה.
ודאו שכתובת האימייל ליצירת קשר עם ה-API מובילה לתיבת דואר נכנס במעקב קבוע. במהלך הבדיקה כדי לקבל הבהרות, צוות התאימות ל-API של Google עשוי לפנות לכתובת האימייל הזו. אם לא ניתן ליצור קשר, ייתכן ש-Google לא תמשיך לטפל בבקשה.
אפשר לערוך את כתובת האימייל ליצירת קשר עם ה-API במרכז ה-API. חשוב לשמור על עדכניות המידע הזה, גם בסיום הטיפול בבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.
אחרי שתשלימו את תהליך הבקשה, קוד המפתח יופיע במרכז ה-API בסטטוס Pending Approval. לקוד המפתח שלכם יש עכשיו רמת גישה לבדיקה, ואפשר להתחיל לשלוח קריאות ל-API כנגד חשבונות בדיקה.
אחרי שתקבלו את קוד המפתח, שימו לב לערך שלו כי תצטרכו אותו כשתשלחו את הקריאה הראשונה ל-API.
איפה נמצא קוד המפתח
תוכלו למצוא את קוד המפתח הקיים בדף API Center של חשבון הניהול ב-Google Ads.
נכנסים לחשבון הניהול ולוחצים על הלחצן חיפוש.
מקלידים "api center" ובוחרים אותו מתוך ההשלמה האוטומטית של החיפוש. האפשרות API Center מופיעה רק בחשבונות ניהול ב-Google Ads, ולא בחשבונות ניהול לבדיקה.
קוד המפתח ורמת הגישה שלו הם הערכים הראשונים בקטע API Access.
