הבקשות ל-ReachPlanService צריכות לספק קוד מפתח מאושר, פרטי כניסה ל-OAuth ומזהה לקוח שאליו יש גישה לפרטי הכניסה שלכם ל-OAuth.
במדריך הזה מפורטים פרטי האימות הספציפיים ל-ReachPlanService. אם עדיין לא עשיתם זאת, קודם כול צריך לבצע את השלבים שמפורטים במאמר תחילת העבודה, ואז לחזור לשלב הזה.
קוד מפתח ופרטי כניסה ל-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, עליכם לבחור אחת משתי הגישות בהתאם למצב שלכם ולזהות כמה מזהי לקוחות לבדיקה. אם יש לכם ספק, כדאי להשתמש בגישה המוצעת הראשונה עבור סוג הכלי.