اختيار نوع التطبيق
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بما أنّ حسابات "إعلانات Google" تحتوي على بيانات المستخدمين، يجب أن يحصل تطبيقك على إذن من المستخدم للوصول إلى هذه البيانات. هناك طريقتان عامّتان للحصول على هذا التفويض.
اختيار نوع التطبيق
بما أنّ حسابات "إعلانات Google" تحتوي على بيانات المستخدمين، يجب أن يحصل تطبيقك على إذن من المستخدم للوصول إلى هذه البيانات. هناك طريقتان عامّتان للحصول على هذا التفويض.
| |
حساب الخدمة |
مصادقة المستخدم |
| ملخّص |
يمكنك ضبط حسابك على "إعلانات Google" يدويًا لمنح حساب خدمة إذن الوصول إلى هذا الحساب. بعد ذلك، يمكن لتطبيقك استخدام بيانات اعتماد حساب الخدمة لإجراء طلبات إلى واجهة برمجة التطبيقات في حساب "إعلانات Google" بدون أي تفاعل من المستخدم. تعمل طلبات البيانات من واجهة برمجة التطبيقات طالما أنّ حساب الخدمة لديه إذن بالوصول إلى حساب "إعلانات Google". |
الحصول على تفويض لمرة واحدة باستخدام بروتوكول OAuth 2.0 من أحد المستخدمين للسماح لتطبيقك بإدارة حسابه على "إعلانات Google" بعد ذلك، يمكن لتطبيقك استخدام رمز التحديث الخاص ببروتوكول OAuth 2.0 (الذي يتم إصداره كجزء من عملية تفويض OAuth 2.0) لإجراء طلبات إلى واجهة برمجة التطبيقات في حساب "إعلانات Google". تعمل طلبات البيانات من واجهة برمجة التطبيقات طالما لم يلغِ المستخدم الإذن، أو إلى أن تنتهي صلاحية الإذن بسبب عدم النشاط أو لأسباب أخرى. |
| سهولة الاستخدام |
الحد الأدنى من الإعدادات والموافقات المطلوبة بسبب عدم توفّر إذن المستخدم في التطبيق |
يتطلّب التطبيق إعدادات وموافقات مكثّفة لأنّ مصادقة المستخدم جزء منه. |
| الإجراء المقترَح |
يُنصح بشدة باتّباع هذه الطريقة |
النهج القديم استخدِم هذه الطريقة كخيار احتياطي عندما يتعذّر عليك منح حساب خدمة الأذونات المطلوبة للوصول إلى حسابك على "إعلانات Google". |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
