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

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

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

  1. مشروع على Google Cloud أو حساب Google تريد أن يملك المشروع

  2. يجب أن تكون Google Cloud CLI مثبَّتة.

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

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

تفعيل Data Manager API

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

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

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

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

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

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

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

حساب المستخدم

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

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

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

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

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

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

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

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

    3. في قائمة النطاقات، ابحث عن Data Manager API وضَع علامة في المربّع بجانب كل نطاق يتطلّبه تطبيقك:

      • .../auth/datamanager: اختَر هذا النطاق لعمليات واجهة برمجة التطبيقات العادية، مثل إدارة بيانات العملاء وشرائح الجمهور والأحداث. هذا هو النطاق الأساسي المستخدَم في هذا الدليل.

      • .../auth/datamanager.partnerlink: اختَر هذا النطاق فقط إذا كنت شريك بيانات ينشئ أو يحذف روابط الشركاء في حسابات المعلِنين.

    4. انقر على تعديل.

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

    6. انتقِل إلى الجمهور في وحدة تحكّم Google Cloud واضبط الإعدادات لعملية التطوير الأولية:

      • اضبط حالة النشر على اختبار.
      • اضبط نوع المستخدم على داخلي (إذا كان مشروعك في مؤسسة على Google Workspace) أو خارجي (إذا لم يكن كذلك).
      • في حال استخدام خارجي، أضِف حسابات Google التي تستخدمها لإنشاء بيانات الاعتماد على أنّها مستخدمون تجريبيون.

      يمكنك الاطّلاع على مزيد من المعلومات حول هذه الإعدادات في مقالة إدارة جمهور التطبيق.

  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

حساب الخدمة

في ما يلي خطوات إنشاء حساب خدمة واستخدام انتحال هوية حساب الخدمة للمصادقة في بيئة تطوير محلية. تستخدم هذه الخطوات ميزة انتحال الهوية بدلاً من مفاتيح حساب الخدمة لأنّ مفاتيح حساب الخدمة يمكن أن تشكّل خطرًا أمنيًا إذا لم تتم إدارتها بعناية.

  1. انقر على الزر إنشاء حساب خدمة التالي أو اتّبِع التعليمات لاختيار حساب خدمة أو إنشائه.

    إنشاء حساب خدمة

  2. امنح حساب الخدمة دور مستهلك استخدام الخدمة في "إدارة الهوية وإمكانية الوصول" (IAM) (roles/serviceusage.serviceUsageConsumer)، والذي يتضمّن إذن serviceusage.services.use الذي يسمح لحساب الخدمة بإرسال طلبات بيانات من واجهة برمجة التطبيقات للمشروع.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. امنح حساب Google دور منشئ الرموز المميّزة لحساب الخدمة في "إدارة الهوية وإمكانية الوصول" (roles/iam.serviceAccountTokenCreator) في حساب الخدمة.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. اضبط ADC من خلال تشغيل الأمر التالي:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

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

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

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

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    عندما يُطلب منك تسجيل الدخول، سجِّل الدخول باستخدام حساب Google الذي يتضمّن دور "منشئ الرمز المميّز لحساب الخدمة".

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

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

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

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

حساب المستخدم

اختَر علامة التبويب التي تتوافق مع حالة الاستخدام.

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

المعلِن

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

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

مساحة العرض والفيديو 360

اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني للمستخدم إلى الحساب.

إحصاءات Google

اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني للمستخدم إلى الحساب.

شريك البيانات

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

أضِف عنوان البريد الإلكتروني للمستخدم إلى حساب شريك البيانات من خلال واجهة مستخدم "إعلانات Google" باتّباع هذه التعليمات.

حساب الخدمة

اختَر علامة التبويب التي تتوافق مع حالة الاستخدام.

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

المعلِن

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

أكمِل إعداد إذن الوصول إلى الحساب لإضافة حساب الخدمة إلى حساب "إعلانات Google" أو إلى حساب إداري رئيسي على "إعلانات Google".

مساحة العرض والفيديو 360

اتّبِع التعليمات لإنشاء مستخدم في "مساحة العرض والفيديو 360" مرتبط بحساب الخدمة.

إحصاءات Google

اتّبِع التعليمات لإضافة عنوان البريد الإلكتروني لحساب الخدمة إلى الحساب.

شريك البيانات

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

تتم إدارة إذن الوصول إلى حساب شريك البيانات من خلال واجهة مستخدم "إعلانات Google". لإضافة حساب الخدمة وضبط مستوى الوصول إليه، اتّبِع الخطوات الواردة في مقالة إعداد إذن الوصول إلى الحساب.

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

التالي
تثبيت مكتبة برامج