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