نظرة عامة

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

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

تستخدم Google APIs بروتوكول OAuth 2.0 للمصادقة والتفويض. في ما يلي كيفية إعداد حساب خدمة للوصول إلى Marketplace API.

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

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

    1. سيتم توجيهك إلى صفحة تحتوي على مربّع بحث. ابحث عن Authorized Buyers Marketplace API.
    2. اختَر Authorized Buyers Marketplace API في صفحة النتائج.
    3. انقر على تفعيل.
  4. في قائمة التنقّل، انقر على بيانات الاعتماد.
  5. انقر على +إنشاء بيانات اعتماد، ثم اختَر حساب الخدمة في القائمة المنسدلة التي تظهر.
  6. أدخِل اسمًا لحساب الخدمة. يتم إنشاء معرّف حساب الخدمة تلقائيًا عند إنشاء الحساب، لذا احفظ هذه القيمة لأنّك ستحتاج إليها لاحقًا في الخطوة 14. أدخِل وصفًا اختياريًا. انقر على إنشاء ومتابعة.
  7. يمكنك ضبط الأذونات لحساب الخدمة والنقر على متابعة.
  8. يمكنك اختياريًا ضبط المستخدمين أو المجموعات التي يمكنها تنفيذ الإجراءات بصفتها حساب الخدمة، ثم النقر على تم.
  9. يظهر حساب الخدمة الجديد ضِمن حسابات الخدمة. ابحث عن معرّف حساب الخدمة الذي أنشأته للتو وانقر عليه.
  10. انقر على علامة التبويب المفاتيح.
  11. في القائمة المنسدلة إضافة مفتاح، اختَر إنشاء مفتاح جديد.
  12. اختَر JSON كـ نوع المفتاح، ثم انقر على إنشاء.
  13. نزِّل المفتاح إلى دليل العمل. لمزيد من المعلومات حول التخزين الآمن للمفتاح، يُرجى الاطّلاع على إدارة مفاتيح حساب الخدمة. يستخدم تطبيقك المفتاح لإجراء طلبات إلى واجهة برمجة التطبيقات.
  14. شارِك رقم تعريف حساب الخدمة مع مدير حسابك الفني لربط حساب الخدمة بحسابك.

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

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

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

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

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

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

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