קבלת קוד מפתח

קוד המפתח הוא מחרוזת אלפאנומרית באורך 22 תווים, שמאפשרת לאפליקציה להתחבר ל-Google Ads API. אחרי ש-Google הקצתה לכם את האסימון, תוכלו להציג אותו או ליצור אסימון חדש בדף API Center בחשבון הניהול ב-Google Ads.

לכל קוד מפתח מוקצית רמת גישה שקובעת את מספר הקריאות ל-API שאפשר לבצע בכל יום באמצעות האסימון, וכן את הסביבה שאליה אפשר לבצע קריאות.

כדי לבצע קריאות ל-API בחשבון בסביבת הייצור, בתהליך היישום של האסימון צריך לבקש Basic Access או Standard Access אל קוד המפתח. מאחר שרמות הגישה האלה לא נדרשות לביצוע קריאות לחשבונות בדיקה, תוכלו להמשיך לתרגילים, אבל מומלץ לקרוא איך מגישים בקשה לקבלת גישה בסיסית בסיום המדריך.

האם יש לך צורך בקוד מפתח חדש?

ההחלטה האם להירשם לקבלת קוד מפתח חדש תלויה בכמה גורמים. הנה כמה מהתרחישים הנפוצים:

תרחיש
השלבים הבאים
החברה שלך לא השתמשה ב-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) ובוחרים אותו מתוך ההשלמה האוטומטית של החיפוש. האפשרות API Center מופיעה רק בחשבונות ניהול ב-Google Ads, ולא בחשבונות מפרסמים או בחשבונות ניהול בדיקה.

ממלאים את טופס הגישה ל-API ומאשרים את התנאים וההגבלות.

  • ודאו שהמידע שלכם נכון ושכתובת ה-URL של החברה שלכם פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה ולדחות אותה.

  • ודאו שכתובת האימייל ליצירת קשר עם ה-API שאתם מספקים מובילה לתיבת דואר נכנס שנמצאת במעקב באופן קבוע. צוות התאימות של Google ל-API עשוי לפנות לכתובת האימייל הזו במהלך הבדיקה כדי לקבל הבהרות. אם לא ניתן ליצור איתכם קשר, יכול להיות ש-Google לא תמשיך בתהליך הבקשה.

    ניתן לערוך את כתובת האימייל ליצירת קשר עם ה-API ב-API Center. חשוב לוודא שהמידע הזה עדכני, גם אחרי תהליך הגשת הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות שירות חשובות.

בסיום תהליך הבקשה, קוד המפתח מופיע במרכז ה-API עם הסטטוס Pending Approval. קוד המפתח שלכם קיבל עכשיו רמת גישה לבדיקה, ותוכלו להתחיל לבצע קריאות ל-API בחשבונות בדיקה.

אחרי שמקבלים את קוד המפתח, חשוב לבדוק את הערך שלו כפי שתזדקקו לו בקריאה הראשונה ל-API.

איפה אפשר למצוא את קוד המפתח

ניתן למצוא קוד מפתח קיים בדף API Center של חשבון הניהול ב-Google Ads.

נכנסים לחשבון הניהול ולוחצים על הלחצן חיפוש.

מקלידים "api center" (מרכז API) ובוחרים אותו מתוך ההשלמה האוטומטית של החיפוש. האפשרות API Center מופיעה רק בחשבונות ניהול ב-Google Ads ולא בחשבונות ניהול לבדיקה.

קוד המפתח ורמת הגישה שלו הם הערכים הראשונים בקטע גישה ל-API.