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