إعداد إذن الوصول إلى واجهة برمجة التطبيقات

في ما يلي كيفية إعداد إذن الوصول إلى Data Manager API باستخدام حزمة تطوير برامج (SDK) أو REST.

اختَر نوع عملية الإعداد التي تريد اتّباعها:

المعلِن شريك البيانات

المتطلبات الأساسية

قبل استخدام Data API، تأكَّد من توفّر ما يلي:

1. مشروع على Google Cloud
2. حساب Google لديه إذن serviceusage.services.enable في مشروعك على Google Cloud، أو لديه دور يتضمّن هذا الإذن على سبيل المثال، يتضمّن كل من roles/owner وroles/serviceusage.serviceUsageAdmin الإذن serviceusage.services.enable. للاطّلاع على أذوناتك، راجِع مقالة عرض إذن الوصول الحالي.
3. تم تثبيت واجهة سطر الأوامر في Google Cloud.

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

إذا لم يسبق لك تفعيل Data Manager API، يمكنك إجراء ذلك من خلال النقر على تفعيل Data Manager API أو اتّباع التعليمات لتنفيذ هذه الخطوة يدويًا.

تفعيل Data Manager API

إذا لم تتمكّن من العثور على Data Manager API أو تعذّر عليك تفعيل Data Manager API، تأكَّد من أنّ حسابك على Google يستوفي المتطلبات الأساسية.

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

يمكنك استخدام أي من طرق المصادقة في Google باستثناء مفاتيح واجهة برمجة التطبيقات. ننصحك بمراجعة كيفية اختيار طريقة المصادقة المناسبة لحالة الاستخدام لتحديد الطريقة المناسبة لحالة الاستخدام.

طريقتان شائعتان للمصادقة هما حسابات المستخدمين وحسابات الخدمة:

• حسابات المستخدمين: تمثّل الأشخاص الذين يتفاعلون مع واجهات برمجة التطبيقات وخدمات Google مباشرةً.
• حسابات الخدمة: تمثّل التطبيقات، وليس الأشخاص، بصفتها المستخدمين. وتتيح هذه الرموز لتطبيقاتك إدارة المصادقة والتفويض. على سبيل المثال، إذا كان أحد التطبيقات بحاجة إلى الوصول إلى موارد Google Cloud.

يمكن أن يستخدم الدمج بيانات الاعتماد التلقائية للتطبيق (ADC) للعثور تلقائيًا على بيانات الاعتماد من البيئة، وبالتالي لن تحتاج إلى تغيير رمز العميل للمصادقة.

اختَر حساب المستخدم أو انتحال هوية حساب الخدمة لإعداد ADC:

حساب المستخدم انتحال هوية حساب الخدمة

في ما يلي خطوات المصادقة باستخدام بيانات اعتماد حساب المستخدم:

1. اضبط إعدادات منصة Google Auth لمشروعك.

   ملاحظة مهمة: يجب أن تخضع أي تطبيقات Google Cloud تُستخدَم للحصول على بيانات اعتماد المستخدمين لنطاق Data Manager API إلى عملية التحقّق من Google OAuth لتجنُّب ظهور شاشة واجهة مستخدم لم يتم التحقّق منها للمستخدمين. لا يلزم إجراء عملية التحقّق من Google OAuth لحسابات الخدمة.

   1. افتح صفحة "تحديد هوية العلامة التجارية" في Google Cloud Console.

   2. اختَر مشروعك.

   3. املأ النموذج وانقر على إنشاء.

2. بما أنّ نطاق Data Manager API هو نطاق حسّاس، يجب اتّباع الخطوات التالية:

   1. انتقِل إلى إعدادات الوصول إلى البيانات لمشروعك.

   2. انقر على إضافة نطاقات أو إزالتها.

   3. ضَع علامة في المربّع بجانب Data Manager API في قائمة النطاقات، ثم انقر على تعديل.

   4. انقر على حفظ.

   5. انتقِل إلى شريحة الجمهور في Google Cloud Console وعدِّل حالة النشر ونوع المستخدم. يمكنك الاطّلاع على مزيد من المعلومات عن هذه الإعدادات في مقالة إدارة جمهور التطبيق.

3. انقر على إنشاء عميل OAuth2 لإنشاء عميل OAuth2 في المشروع، أو اتّبِع التعليمات لإنشاء عميل OAuth2 تطبيق مكتبي. يمكنك تخطّي هذه الخطوة إذا كان لديك عميل OAuth2 متوافق مع أجهزة سطح المكتب تريد استخدامه مع Data Manager API.

   إذا نقرت على إنشاء عميل OAuth2، اختَر تطبيق على الكمبيوتر عند مطالبتك بإعداد عميل OAuth حتى تتمكّن من استخدام العميل في الخطوات المتبقية.

   إنشاء عميل OAuth2

   في الخطوة الأخيرة، انقر على تنزيل إعدادات العميل واحتفظ بمكان التنزيل الذي تختاره.

4. أنشئ ملف ADC محليًا من خلال تنفيذ الأمر التالي. يؤدي هذا الأمر إلى تشغيل عملية على الويب حيث يُطلب منك تسجيل الدخول إلى حساب Google الذي تستخدمه مع واجهة برمجة التطبيقات.

   استبدِل PATH_TO_CLIENT_JSON باسم ملف JSON الذي نزّلته.

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   إذا كنت تريد استخدام بيانات الاعتماد نفسها لواجهة Data Manager API وGoogle Ads API، أدرِج نطاق Google Ads API في قائمة --scopes:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   إذا كنت تريد استخدام بيانات الاعتماد نفسها لواجهة برمجة التطبيقات Data Manager API وDisplay & Video 360 API، أدرِج نطاق Display & Video 360 API في --scopesالقائمة:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

5. تأكَّد من إعداد بيانات الاعتماد بشكل صحيح باستخدام الأمر التالي. في حال نجاح هذا الإجراء، سيطبع الأمر رمز دخول إلى وحدة التحكّم.

   gcloud auth application-default print-access-token
   

ملاحظة: النطاق https://www.googleapis.com/auth/datamanager مطلوب لجميع الخدمات في Data Manager API.

لمزيد من المعلومات عن المصادقة وبيانات الاعتماد لتطبيقك، يُرجى الاطّلاع على طرق المصادقة في Google وطريقة عمل بيانات الاعتماد التلقائية للتطبيقات.

إعداد إذن الوصول إلى الحساب

امنح عنوان البريد الإلكتروني المرتبط بحساب المستخدم إذن الوصول إلى Destination.

• في حال استخدام حساب على "إعلانات Google"، اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني للمستخدم إلى حساب "إعلانات Google" أو إلى حساب إداري رئيسي على "إعلانات Google".
• في حال استخدام حساب على "مساحة العرض والفيديو 360"، اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني للمستخدم إلى الحساب.
• في حال استخدام موقع على "إحصاءات Google"، اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني للمستخدِم إلى الحساب.

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

ثبِّت مكتبة برامج ونفِّذ نماذج الرموز البرمجية لتجربة طلبك الأول من Data Manager API.