نوع برنامه خود را انتخاب کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
از آنجایی که حساب‌های Google Ads حاوی داده‌های کاربر هستند، برنامه شما باید مجوز دسترسی به این داده‌ها را از کاربر دریافت کند. دو رویکرد کلی بر اساس نحوه دریافت این مجوز وجود دارد.
نوع برنامه خود را انتخاب کنید
از آنجایی که حساب‌های Google Ads حاوی داده‌های کاربر هستند، برنامه شما برای دسترسی به این داده‌ها باید از کاربر مجوز بگیرد. دو رویکرد کلی بر اساس نحوه دریافت این مجوز وجود دارد.
| حساب خدمات | احراز هویت کاربر |
|---|
| خلاصه | حساب Google Ads خود را به صورت دستی پیکربندی کنید تا به یک حساب سرویس دسترسی به آن حساب بدهید. پس از آن، برنامه شما می‌تواند از اعتبار حساب سرویس برای برقراری تماس‌های API با حساب Google Ads بدون هیچ گونه تعامل کاربر استفاده کند. تماس‌های API تا زمانی کار می‌کنند که حساب سرویس به حساب Google Ads دسترسی داشته باشد. | یک بار مجوز OAuth 2.0 را از یک کاربر دریافت کنید تا به برنامه شما اجازه دهد حساب Google Ads خود را مدیریت کند. پس از آن، برنامه شما می‌تواند از نشانه بازخوانی OAuth 2.0 (که به عنوان بخشی از فرآیند مجوز OAuth 2.0 صادر شده است) برای برقراری تماس‌های API با حساب Google Ads استفاده کند. تماس‌های API تا زمانی کار می‌کنند که کاربر مجوز را لغو نکند، یا تا زمانی که مجوز به دلیل عدم فعالیت یا دلایل دیگر منقضی شود. |
|---|
| سهولت استفاده | به دلیل عدم مجوز کاربر در برنامه، حداقل پیکربندی و تأییدیه مورد نیاز است. | پیکربندی و تأییدیه‌های گسترده مورد نیاز به دلیل تأیید هویت کاربر که بخشی از برنامه است. |
|---|
| توصیه | به شدت به عنوان رویکرد ترجیحی توصیه می شود | رویکرد میراثی زمانی که نمی توانید مجوزهای لازم را به حساب Google Ads خود به یک حساب سرویس بدهید، به عنوان گزینه بازگشتی استفاده کنید. |
|---|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Choose your application type\n\nSince Google Ads accounts contain user data, your application must obtain\nauthorization from the user to access this data. There are two broad approaches\nbased on how you obtain this authorization.\n\nChoose your app type\n--------------------\n\nSince Google Ads accounts contain user data, your app needs to obtain\nauthorization from the user to access this data. There are two broad approaches\nbased on how you obtain this authorization.\n\n| | **Service Account** | **User Authentication** |\n| Summary | Manually configure your Google Ads account to give a service account access to that account. Afterwards, your app can use the service account credentials to make API calls to the Google Ads account without any user interaction. The API calls work as long as the service account has access to the Google Ads account. | Obtain a one-time OAuth 2.0 authorization from a user to allow your app to manage their Google Ads account. Afterwards, your app can use the OAuth 2.0 refresh token (issued as part of the OAuth 2.0 authorization process) to make API calls to the Google Ads account. The API calls work as long as the user doesn't revoke the authorization, or until the authorization expires due to inactivity or other reasons. |\n| Ease of use | Minimal configuration and approvals required due to lack of user authorization in the app. | Extensive configuration and approvals required due to user authentication being part of the app. |\n| Recommendation | **Strongly recommended** as the preferred approach | Legacy approach. Use as a fallback option when you cannot give a service account the required permissions to your Google Ads account. |\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
