בקשות שנשלחות ל-ReachPlanService צריכות לספק קוד מפתח מאושר, פרטי כניסה ל-OAuth ומספר לקוח שאפשר לגשת אליו לפרטי הכניסה של OAuth.
במדריך הזה מפורטים פרטי האימות הספציפיים ל-ReachPlanService. אם עדיין לא עשיתם זאת, קודם מבצעים את השלבים שמפורטים בקטע Get started (מתחילים) וחוזרים לנקודה הזו.
קוד מפתח ופרטי כניסה של OAuth
נוסף על ההנחיות במאמר Get started (תחילת העבודה), חשוב לזכור את הנקודות הבאות:
- קוד המפתח שלכם חייב להיכלל ברשימת ההיתרים כדי להתחבר אל
ReachPlanService, גם אם הוא כבר אושר לשימוש בשירותים אחרים של Google Ads API. למידע נוסף, כדאי לעיין בדרישות הסף. - כדי להתחבר ל-Google Ads API, אתם צריכים לאשר את התנאים וההגבלות של Google Ads API.
- המשתמש שבבעלותו אסימון הרענון של OAuth קובע על אילו מספרי לקוח אפשר לשלוח שאילתות ב-
ReachPlanService. כך תקבלו מידע על השילוב והסברים נוספים בהמשך.
מספרי זיהוי של לקוח:
רוב השירותים ב-Google Ads API פועלים בחשבונות Google Ads ובקמפיינים ספציפיים. כתוצאה מכך, ברוב הבקשות צריך לציין גם מספר לקוח כדי לזהות את החשבון שאתם מנהלים או שולחים שאילתות, וגם את פרטי הכניסה ל-OAuth שיש להם הרשאת גישה למספר הלקוח הזה. עם זאת, ReachPlanService מיועד לפעילויות של תכנון סרטונים שעשויות להתרחש לפני שאתם יודעים את מספר הלקוח הספציפי שבו תפעילו את הקמפיין.
לשותפים שיוצרים כלים לשימוש פנימי בארגון שלהם, אנחנו ממליצים על אחת מהאפשרויות הבאות:
אם למתכננים שלכם אין גישה לחשבונות Google Ads של הלקוחות: יוצרים פרטי כניסה ל-OAuth באמצעות תהליך האפליקציה המותקן בשביל משתמש שיש לו גישה לחשבון הניהול של קוד המפתח שלכם. לאחר מכן צריך ליצור או להשיג חשבון Google Ads לכל צוות שמשתמש בכלי, ולקשר אותו לחשבון הניהול. כששולחים בקשות ל-
ReachPlanService, צריך לספק את מספר הלקוח בהתאם לצוות של המשתמש.אם למתכננים יש גישה לחשבון ניהול ב-Google Ads שמנהל את חשבונות הלקוחות: מטמיעים את התהליך לאפליקציות אינטרנט כדי לאפשר לאפליקציה להשתמש בפרטי הכניסה ל-OAuth של כלי התכנון. לאחר מכן תוכלו להעביר את מספר הלקוח שתואם ללקוח בתוכנית.
אנחנו ממליצים לשותפים שבונים כלי למשתמשים חיצוניים לגשת לגישות דומות:
יוצרים פרטי כניסה של OAuth באמצעות תהליך האפליקציה המותקן למשתמש שיש לו גישה לחשבון הניהול של קוד המפתח שלכם. יוצרים חשבון Google Ads לכל לקוח חיצוני ומקשרים אותו לחשבון הניהול. לאחר מכן צריך להגדיר את הכלי כך שיספק את מספר הלקוח התואם של הלקוח בזמן שהוא יוצר תוכניות.
תוכלו לתת למשתמשים את היכולת להעניק לכלי גישה לחשבונות שלהם באמצעות תהליך של אפליקציית אינטרנט. אחרי שמשתמש מעניק הרשאה, משתמשים ב-
CustomerServiceכדי לספק לו רשימה של חשבונות Google Ads שיש לו גישה אליו.
המטרה היא לוודא שהכלי תכנון עם חיכוך קל ככל האפשר כשמשתמשים ב-ReachPlanService. לפני שמשלבים את ה-API, צריך לבחור אחת משתי הגישות בהתאם למצב שלכם ולזהות כמה מזהי לקוחות לבדיקה. אם יש לכם ספק, כדאי להשתמש בגישה המוצעת הראשונה לסוג הכלי שלכם.