إعداد المصادقة

إعداد واجهة برمجة التطبيقات Display &Video 360 Seller API

هناك بضع خطوات أساسية لإعداد واجهة برمجة التطبيقات Display &Video 360 Seller API. واجهة برمجة التطبيقات DV360 Seller API هي واجهة برمجة تطبيقات Google Cloud تستند إلى قائمة السماح وتستخدم بروتوكول OAuth 2.0 للمصادقة والتفويض.

يتولّى فريق واجهة برمجة التطبيقات Display &Video 360 Seller API عملية إضافة الحسابات إلى قائمة السماح.

ملاحظة: إذا كان تطبيقك يصل إلى واجهة برمجة التطبيقات DV360 Seller API، يجب أن يجتاز مراجعة التحقّق من بروتوكول OAuth. إذا ظهرت لك الرسالة تطبيق لم يتم التحقّق منه على الشاشة عند اختبار تطبيقك، عليك إرسال طلب للتحقّق من التطبيق لإزالة هذه الرسالة. مزيد من المعلومات عن التطبيقات التي لم يتم التحقّق منها أو إجابات عن الأسئلة الشائعة حول التحقّق من التطبيق.

خطوات الإعداد:

1. يمكنك الاشتراك في حساب Google من خلال الانتقال إلى https://console.cloud.google.com/.
   • سيتم استخدام هذا الحساب لإدارة رموز الوصول المميزة لعميلك في مرحلة الإنتاج. يُرجى عدم استخدام حساب Gmail شخصي.
   • لا يمكن أن يكون الحساب مجموعة Google.
   • إذا كنت تستخدم مشروعًا حاليًا على Google Cloud: يجب أن يكون الحساب مشرفًا على المشروع.
2. يُرجى التواصل مع فريق Google DV360 وتقديم تفاصيل حسابك لإضافته إلى قائمة السماح.
3. يُرجى انتظار التأكيد على تفعيل حسابك.
4. خطوة اختيارية وغير ضرورية: يمكنك إرسال طلب مراجعة للتحقّق من بروتوكول OAuth لتطبيقك من أجل الوصول إلى النطاق https://www.googleapis.com/auth/doubleclickbidmanager.
5. في Google Cloud Console، انتقِل إلى واجهات برمجة التطبيقات والخدمات > المكتبة > خاصة. من المفترض أن تظهر لك واجهة برمجة التطبيقات DV360 Seller API المتاحة لمشروعك.
6. فعِّل واجهة برمجة التطبيقات DV360 Seller API.
7. انتقِل إلى واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد > إنشاء بيانات اعتماد > مفتاح حساب خدمة. اتّبِع تعليمات الإعداد في مستند حساب خدمة OAuth 2.0.

   إعداد حساب خدمة:

   ملاحظة: يُرجى إعلامنا إذا كنت تريد إعادة استخدام حساب خدمة حالي، مثل حساب مستخدَم لواجهة برمجة التطبيقات DV360 Reporting API.

   تتم عادةً المصادقة والتفويض في Google Cloud API (يُشار إليهما عادةً باسم "المصادقة") باستخدام حساب خدمة. يسمح حساب الخدمة للرمز البرمجي بإرسال بيانات اعتماد التطبيق مباشرةً إلى Cloud API. يتم تمثيل حساب الخدمة، مثل حساب المستخدم، بعنوان بريد إلكتروني. على عكس حساب المستخدم، ينتمي حساب الخدمة إلى تطبيق فقط، ولا يمكن استخدامه إلا للوصول إلى واجهة برمجة التطبيقات التي تم إنشاؤه من أجلها. على سبيل المثال، سنوضّح كيفية إنشاء بيانات اعتماد حساب خدمة باستخدام Google Cloud Platform Console.

   استخدام Google Cloud Console

   من صفحة إدارة واجهات برمجة التطبيقات→"بيانات الاعتماد" في Google Cloud Console، انقر على "إنشاء بيانات اعتماد→مفتاح حساب خدمة".

   

   بعد ذلك، انقر على "حساب خدمة جديد" من القائمة المنسدلة "حساب الخدمة".

   

   اكتب "اسمًا" لحساب الخدمة هذا. سيتم استخدام هذا الاسم كاسم تلقائي لـ "معرّف حساب الخدمة" (على يسار الرمز "@" في عنوان معرّف حساب الخدمة الذي تم إنشاؤه)، ولكن يمكنك تغيير اسم معرّف حساب الخدمة هذا إذا أردت. يمكن أن تكون هذه الأسماء عشوائية، ولكن من المهم أن تتذكرها. ضمن "نوع المفتاح"، ننصحك بترك هذه القيمة على "JSON". انقر على "إنشاء"، وسينشئ GCP Console مفتاح 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>[e-mail]",
     "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.

8. يُرجى التواصل مع فريق DV360 وتقديم معلومات حساب الخدمة الذي أنشأته (عنوان البريد الإلكتروني لحساب الخدمة تحديدًا). هذه خطوة ثانية لإضافة الحسابات إلى قائمة السماح من أجل التفويض.
9. بعد تفويض حساب الخدمة لاستدعاء واجهة برمجة التطبيقات، يمكنك الرجوع إلى مستندات واجهة برمجة التطبيقات DV360 Seller API. للحصول على رمز تفويض يدويًا، يُرجى الاطّلاع على التعليمات في مستودع أداة oauth2l (باستخدام مفتاح حساب الخدمة بتنسيق JSON الذي نزّلته). تتوفّر تعليمات مفصّلة حول الحصول على رموز OAuth المميزة آليًا في مستندات مصادقة Google Cloud.

ملاحظة مهمة: يجب أن يكون نطاق OAuth هو https://www.googleapis.com/auth/doubleclickbidmanager