إعداد واجهة برمجة التطبيقات الخاصة بالبائع في "مساحة العرض والفيديو 360"
هناك بعض الخطوات الرئيسية لإعداد واجهة برمجة تطبيقات لخدمة DV360 Seller API. يتم عرض واجهة برمجة التطبيقات Seller API في "مساحة العرض 360" كواجهة برمجة تطبيقات Google Cloud API مستندة إلى القائمة المسموح بها، وتستخدم OAuth للمصادقة.
سيتمّ التعامل مع عملية القائمة المسموح بها من خلال التواصل مع فريق DV360 Seller API.
خطوات الإعداد:
- سجِّل حسابًا على Google من خلال الانتقال إلى https://console.cloud.google.com/
- سيتم استخدام هذا الحساب لإدارة الرموز المميّزة للوصول إلى حساب العميل في قناة الإصدار العلني. لا تستخدِم حسابك الشخصي على Gmail.
- لا يمكن أن يكون الحساب مجموعة على Google.
- إذا كنت تستخدِم مشروعًا حاليًا على Google Cloud: يجب أن يكون الحساب مشرفًا للمشروع.
- يُرجى التواصل مع فريق Google DV360 وإرسال معلومات الحساب الذي اشتركت فيه لإضافته إلى قائمة المسموح بها.
- انتظِر حتى تتم إضافة حسابك إلى القائمة المسموح بها.
- اختياري ولا يؤدي إلى حظر التطبيق: أرسِل طلب مراجعة عملية إثبات الهوية باستخدام OAuth لتطبيقك من أجل الوصول إلى النطاق(doubleclickbidmanager).
- انتقِل إلى https://console.cloud.google.com/. انتقِل إلى "واجهات برمجة التطبيقات والخدمات" -> المكتبة -> خاص. من المفترض أن تظهر لك واجهة برمجة التطبيقات Seller API في "مساحة العرض والفيديو 360" كإحدى واجهات برمجة التطبيقات المتاحة لك.
- تفعيل DV360 Seller API
- انتقِل إلى "بيانات الاعتماد" -> إنشاء بيانات اعتماد -> مفتاح حساب الخدمة. اتّبِع التعليمات الواردة هنا: https://developers.google.com/identity/protocols/OAuth2ServiceAccount
إعداد حساب خدمة:
ملاحظة: يُرجى إعلامنا إذا أردت إعادة استخدام حساب خدمة حالي، مثل DV360 Reporting API.تتم عادةً عملية المصادقة والتفويض في Google Cloud API (التي يتم تجميعها عادةً معًا باسم "المصادقة") باستخدام حساب خدمة. يتيح حساب الخدمة لرمزك إرسال بيانات اعتماد التطبيق مباشرةً إلى واجهة برمجة تطبيقات Cloud. يتم تمثيل حساب الخدمة، مثل حساب المستخدم، من خلال عنوان بريد إلكتروني. على عكس حساب المستخدم، لا ينتمي حساب الخدمة إلا إلى تطبيق معيّن، ولا يمكن استخدامه إلا للوصول إلى واجهة برمجة التطبيقات التي تم إنشاؤه من أجلها. على سبيل المثال، سنوضّح كيفية إنشاء بيانات اعتماد حساب الخدمة باستخدام Google Cloud Platform Console.
باستخدام Google Cloud Console
من صفحة مدير واجهة برمجة التطبيقات (API Manager) في Google Cloud Console → بيانات الاعتماد (Credentials)، اختَر "إنشاء بيانات اعتماد (Create credentials) → مفتاح حساب الخدمة (Service account key)".
بعد ذلك، اختَر "حساب خدمة جديد" من القائمة المنسدلة "حساب الخدمة".
اكتب "اسمًا" لحساب الخدمة هذا. سيتم استخدام هذا الاسم كاسم تلقائي "لمعرّف حساب الخدمة" (على يمين "@" في عنوان معرّف حساب الخدمة الذي تم إنشاؤه)، ولكن يمكنك تغيير اسم معرّف حساب الخدمة هذا إذا أردت ذلك. يمكن أن تكون هذه الأسماء عشوائية، ولكن من المهم فقط تذكُّرها. ضمن "نوع المفتاح"، ننصحك بإبقاء هذه القيمة على "JSON". انقر على "إنشاء"، وستنشئ وحدة تحكّم Google Cloud Platform مفتاح JSON (بتنسيق ملف نصي
.json
)، وسيُطلب منك تنزيل الملف على جهاز الكمبيوتر، وسيظهر لك مربّع حوار تم إنشاء حساب الخدمة.سيكون مفتاح JSON الذي تم إنشاؤه مشابهًا لنموذج مفتاح JSON التالي:
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }
احفظ ملف JSON هذا بأمان، لأنّه يحتوي على مفتاحك الخاص (وهذا الملف هو النسخة الوحيدة من هذا المفتاح). ستحتاج إلى الإشارة إلى ملف مفتاح حساب الخدمة هذا في الرمز البرمجي عندما تريد إرسال بيانات الاعتماد إلى واجهة برمجة التطبيقات Google Cloud Platform API.
- تواصَل مع فريق "مساحة العرض والفيديو 360" باستخدام معلومات حساب الخدمة التي أنشأتها. سنحتاج تحديدًا إلى عنوان البريد الإلكتروني لحساب الخدمة هذا. هذه عملية أخرى للسماح بعمليات التفويض.
- بعد أن يتم تفويض حساب الخدمة باستدعاء واجهة برمجة التطبيقات، يمكنك الرجوع إلى https://developers.google.com/display-video/seller للحصول على مستندات واجهة برمجة التطبيقات. للحصول على الرمز المميّز لمنح الأذونات يدويًا، اطّلِع على التعليمات هنا: https://github.com/google/oauth2l. (يجب أن يكون لديك نسخة JSON من مفتاح حساب الخدمة). تتوفّر أيضًا تعليمات مفصّلة حول كيفية الحصول على رمز Oauth المميّز آليًا على الرابط التالي: https://cloud.google.com/docs/authentication/production.
ملاحظة مهمة: يجب أن يكون نطاق OAuth هو "doubleclickbidmanager"