קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כששולחים בקשות אל ReachPlanService צריך לספק קוד מפתח מאושר, פרטי כניסה ל-OAuth ומספר הלקוח שאפשר לגשת אליו דרך פרטי הכניסה האלה.
במדריך הזה מופיעים פרטי האימות שספציפיים ל-ReachPlanService. קודם צריך לסיים את השלבים שמפורטים במאמר תחילת העבודה, ואז לחזור לכאן.
קוד מפתח ופרטי כניסה של OAuth
בנוסף להנחיות שמופיעות במאמר תחילת העבודה, חשוב לזכור את הדברים הבאים:
כדי להתחבר אל 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, תצטרכו לבחור אחת משתי הגישות בהתאם למצב שלכם ולציין לעצמכם כמה מספרי לקוחות שתוכלו לבדוק. אם אתם לא בטוחים, אנחנו ממליצים לכם להשתמש בגישה הראשונה שמוצעת לסוג הכלי שאתם משתמשים בו.
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[[["\u003cp\u003eThe ReachPlanService API requires allowlisted access, an approved developer token, OAuth credentials, and a valid customer ID.\u003c/p\u003e\n"],["\u003cp\u003eYour developer token needs to be specifically allowlisted for ReachPlanService, and you must accept the Google Ads API Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eCustomer ID selection depends on whether planners have access to client accounts or use a manager account, impacting OAuth credential flow.\u003c/p\u003e\n"],["\u003cp\u003ePartners building internal tools can choose between using a manager account with linked team accounts or leveraging planners' existing manager account access.\u003c/p\u003e\n"],["\u003cp\u003ePartners building external tools can use a similar approach, either linking client accounts to a manager account or utilizing the web application flow for direct user account access.\u003c/p\u003e\n"]]],[],null,["# Authentication\n\n| **Important:** This feature is available to allowlisted accounts only. Contact your Google representative if you need access to the feature.\n\n\u003cbr /\u003e\n\nRequests to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) must\nsupply an approved developer token, OAuth credentials, and a customer ID that\nyour OAuth credentials can access.\n\nThis guide covers authentication details specific to\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). If you haven't already,\nfirst complete the steps outlined in [Get\nstarted](/google-ads/api/docs/get-started/introduction), then come back to this point.\n\nDeveloper token and OAuth credentials\n-------------------------------------\n\nIn addition to the guidance presented by [Get\nstarted](/google-ads/api/docs/get-started/introduction), keep the following points in mind:\n\n1. Your developer token must be allowlisted to connect to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService), even if it's already approved for use with other Google Ads API services. For more information, see the [eligibility\n requirements](/google-ads/api/docs/reach-forecasting#eligibility).\n2. You must accept the Google Ads API Terms of Service in order to connect to the Google Ads API.\n3. The user who owns your OAuth refresh token determines which customer IDs you can query in the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). This informs your integration and is explained in more details below.\n\nCustomer IDs\n------------\n\nMost services within the Google Ads API operate on specific Google Ads accounts and\ncampaigns. As a result, most requests require both a customer ID to identify\nthe account you're managing or querying, and [OAuth\ncredentials](/google-ads/api/docs/oauth/overview) that have permission to access that\ncustomer ID. However, [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService)\nis meant for video planning activities that might occur before you know the\nspecific customer ID where you would run a campaign.\n\nFor partners who build tools for internal use in their organization, we\nrecommend one of the following choices:\n\n1. **If your planners don't have access to your clients' Google Ads accounts** :\n Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Then create or obtain\n a Google Ads account for each team that uses your tool, and [link them to\n your manager account](//support.google.com/google-ads/answer/7459601). When making requests to\n [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) provide the customer ID\n corresponding to a user's team.\n\n2. **If your planners have access to a Google Ads manager account that manages\n your clients' accounts** : Implement the *web application flow* to allow your\n app to use your planners' OAuth credentials. Then you can pass in the\n customer ID corresponding to the customer of your plan.\n\nFor partners who build a tool for external users, we recommend similar\napproaches:\n\n1. Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Create a Google Ads\n account per external client and [link them to your manager\n account](//support.google.com/google-ads/answer/7459601). Then configure your tool to provide a client's\n corresponding customer ID when they're generating plans.\n\n2. Give your users the ability to grant your tool access to their accounts\n by using the *web application flow* . Once a user grants permission, use the\n [`CustomerService`](/google-ads/api/docs/account-management/listing-accounts) to provide\n them with a list of Google Ads accounts they can access.\n\nThe goal is to ensure planners have the lowest possible friction when using the\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). Before you integrate the\nAPI, select one of the two approaches according to your situation and identify\na few customer IDs to test. If in doubt, use the first suggested approach for\nyour tool type."]]
