نعمل حاليًا على نقل مجموعة فرعية من أنواع التقارير من التقارير بلا إنترنت إلى التقارير الفورية. بعد نقل بيانات المستخدِم، ستتضمّن ردود
queries.list
تقارير فورية حالية. ويمكنك الاطّلاع على
مشاركة المدونة للحصول على مزيد من المعلومات.
الموافقة على الطلبات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عندما يطلب تطبيقك بيانات خاصة، يجب أن يتم الموافقة على الطلب من خلال جهة اعتماد
المستخدم الذي لديه حق الوصول إلى هذه البيانات.
يجب أن يشتمل كل طلب يرسله تطبيقك إلى واجهة برمجة تطبيقات إدارة عرض السعر على رمز مميز للتفويض. الرمز المميّز
تعرف أيضًا على تطبيقك لـ Google.
لمحة عن بروتوكولات الموافقة على الطلبات
يجب أن يستخدم تطبيقك OAuth 2.0 للسماح بالطلبات.
ولا يُسمح باستخدام أي بروتوكولات أخرى للموافقة على الطلبات. إذا كان تطبيقك يستخدم تسجيل الدخول باستخدام حساب Google، ستتم معالجة بعض جوانب الحصول على الإذن من أجل:
يناسبك ذلك.
الموافقة على الطلبات باستخدام OAuth 2.0
يجب أن يوافق مستخدم مصادَق عليه على كلّ الطلبات الموجّهة إلى واجهة برمجة تطبيقات Bid Manager.
تمثل تفاصيل عملية التفويض أو "التدفق" بالنسبة إلى بروتوكول OAuth 2.0 تختلف إلى حد ما حسب
حول نوع التطبيق الذي تكتبه. وتسري العملية العامة التالية على جميع أنواع التطبيقات:
- عند إنشاء تطبيقك، عليك تسجيله باستخدام وحدة التحكم في واجهة Google API. توفر Google بعد ذلك المعلومات التي ستحتاج إليها
لاحقًا، مثل مُعرّف العميل وسر العميل.
- إرسال التحقق باستخدام OAuth
مراجعة لتطبيقك من أجل الوصول إلى نطاق واجهة برمجة تطبيقات إدارة عرض السعر.
- تفعيل واجهة برمجة تطبيقات إدارة عرض السعر في وحدة التحكم في واجهة Google API. (إذا لم تكن واجهة برمجة التطبيقات مدرجة في علامة
API Console، ثم تخطي هذه الخطوة).
- عندما يحتاج تطبيقك إلى الوصول إلى بيانات المستخدمين، يطلب التطبيق من Google نطاق محدّدًا من
الوصول إليه.
- يعرض Google شاشة الموافقة للمستخدم، ويطلب منه السماح لتطبيقك بتنفيذ الإجراءات التالية:
الوصول إلى بعض بياناتها.
- إذا وافق المستخدِم، ستمنح Google تطبيقك رمز دخول قصير الأجل.
- يطلب تطبيقك بيانات المستخدمين، مع إرفاق رمز الدخول بالطلب.
- يعرض Google البيانات المطلوبة بعد تحققه من صلاحية طلبك ورمز الدخول.
تتضمن بعض التدفقات خطوات إضافية، مثل استخدام رموز مميزة لإعادة التحميل للحصول على إمكانية وصول جديدة
الرموز المميزة. للحصول على معلومات تفصيلية عن التدفقات في الأنواع المختلفة من التطبيقات، راجِع مستندات OAuth 2.0 في Google.
نطاق OAuth
في ما يلي معلومات عن نطاق OAuth 2.0 في واجهة برمجة تطبيقات إدارة عرض السعر:
النطاق |
المعنى |
https://www.googleapis.com/auth/doubleclickbidmanager |
الإذن بالقراءة والتعديل |
لطلب الوصول باستخدام OAuth 2.0، يحتاج تطبيقك إلى معلومات النطاق، بالإضافة إلى
المعلومات التي توفِّرها Google عند تسجيل تطبيقك (مثل معرِّف العميل
سر العميل).
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Applications need authorization from an authenticated user to access private data through the Bid Manager API."],["The Bid Manager API exclusively supports OAuth 2.0 for authorization and requires apps to pass an OAuth verification review."],["Apps must be registered using the Google API Console, undergo an OAuth verification review, and request specific scopes for data access."],["Upon user consent, Google provides a short-lived access token which the app uses to make authorized requests for user data."]]],["Apps requesting private data through the Bid Manager API must be authorized by an authenticated user via OAuth 2.0. The process involves registering the app with Google, submitting an OAuth verification request, and activating the API. The app then requests a specific access scope, prompting a user consent screen. Upon approval, Google issues a short-lived access token. This token is included in data requests, allowing Google to validate the request and return data. The available scope is for read/write access.\n"]]