نظرة عامة

يمكنك إنشاء شرائح بيانات وإدارتها باستخدام Curation Partners API، الذي يعرض curators.dataSegments كمورد. هذه واجهة REST API تتضمّن مكتبات عميل تم إنشاؤها يمكنك استخدامها في عملية الدمج.

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

تستخدم Google APIs بروتوكول OAuth 2.0 للمصادقة والتفويض. في ما يلي كيفية إعداد حساب خدمة للوصول إلى واجهة برمجة التطبيقات الخاصة بـ "شركاء تنظيم المحتوى".

  1. إذا لم يسبق لك ذلك، أنشئ مشروعًا على Google Cloud يستضيف بيانات الاعتماد المستخدَمة للوصول إلى واجهة برمجة التطبيقات.

  2. انتقِل إلى صفحة واجهات برمجة التطبيقات المفعّلة في Google Cloud Console. اختَر المشروع الذي أنشأته في وقت سابق.

  3. راجِع قائمة واجهات برمجة التطبيقات والخدمات المفعَّلة. للوصول إلى Curation Partners API، يجب تفعيلها. إذا لم تكن واجهة Curation Partners API مفعّلة، انقر على +تفعيل واجهات برمجة التطبيقات والخدمات واتّبِع التعليمات التالية:

    1. ابحث عن Curation Partners API باستخدام مربّع البحث.
    2. اختَر Curation Partners API في صفحة النتائج.
    3. انقر على تفعيل.

    من المشاكل المعروفة أنّه قد يتعذّر عليك العثور على Curation Partners API باستخدام مربّع البحث في Google Cloud Console. كبديل، يمكنك استخدام Google Cloud CLI لتفعيل واجهة برمجة التطبيقات بدلاً من ذلك. بعد تثبيت gcloud CLI، يمكنك تفعيل Curation Partners API باستخدام الأمر التالي:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. في قائمة التنقّل، انقر على بيانات الاعتماد.

  5. انقر على +إنشاء بيانات اعتماد، ثم اختَر حساب الخدمة في القائمة المنسدلة التي تظهر.

  6. أدخِل اسمًا لحساب الخدمة. يتم إنشاء رقم تعريف حساب الخدمة تلقائيًا عند إنشاء الحساب، لذا احفظ هذه القيمة لأنّك ستحتاج إليها لاحقًا في الخطوة 14. أدخِل وصفًا اختياريًا. انقر على إنشاء ومتابعة.

  7. يمكنك ضبط أذونات حساب الخدمة بشكل اختياري، ثم النقر على متابعة.

  8. يمكنك اختياريًا ضبط المستخدمين أو المجموعات التي يمكنها تنفيذ الإجراءات بصفتها حساب الخدمة، ثم النقر على تم.

  9. يظهر حساب الخدمة الجديد ضِمن حسابات الخدمة. ابحث عن معرّف حساب الخدمة الذي أنشأته للتو وانقر عليه.

  10. انقر على علامة التبويب المفاتيح.

  11. في القائمة المنسدلة إضافة مفتاح، اختَر إنشاء مفتاح جديد.

  12. اختَر JSON كـ نوع المفتاح، ثم انقر على إنشاء.

  13. نزِّل المفتاح إلى دليل العمل. لمزيد من المعلومات حول تخزين المفتاح بشكل آمن، يُرجى الاطّلاع على إدارة مفاتيح حساب الخدمة. يستخدم تطبيقك المفتاح لإجراء طلبات البيانات من واجهة برمجة التطبيقات.

  14. شارِك رقم تعريف حساب الخدمة مع مدير حسابك الفني لربط حساب الخدمة بحسابك.

نطاقات واجهة برمجة التطبيقات

عند اتّباع خطوات عملية OAuth 2.0 للحصول على رمز دخول يُستخدَم لإجراء طلب إلى واجهة برمجة التطبيقات، عليك تحديد واجهات برمجة التطبيقات التي يمكن الوصول إليها باستخدام هذا الرمز. بالنسبة إلى Curation Partners API، يكون النطاق https://www.googleapis.com/auth/curation-partners.

كيفية تحديد شرائح البيانات في واجهة برمجة التطبيقات مقارنةً بميزة "التنظيم في الوقت الفعلي"

في Curation Partners API، يتم تحديد شرائح البيانات باستخدام مرجع اسم خاص بواجهة برمجة التطبيقات، مثل:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

عند تحديد شرائح البيانات ذات الصلة بفرصة عرض الإعلان في ميزة "التنظيم في الوقت الفعلي"، حدِّد قيمة معرّف المورد DATA_SEGMENT_ID بدلاً من اسم المورد الكامل الذي توفّره واجهة برمجة التطبيقات في الحقل name.

الخطوات التالية