Authentication

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

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

بيانات اعتماد OAuth

بالإضافة إلى الإرشادات المقدَّمة في البدء، يُرجى مراعاة النقاط التالية:

1. يجب إضافة رقم مشروعك على Google Cloud إلى قائمة السماح المناسبة لإجراء الربط مع ReachPlanService، حتى إذا كان قد تمت الموافقة عليه مسبقًا لاستخدامه مع خدمات أخرى في Google Ads API. لمزيد من المعلومات، راجِع متطلبات الأهلية.
2. يجب قبول بنود خدمة Google Ads API من أجل الربط بواجهة Google Ads API.
3. يحدّد المستخدم الذي يملك رمز OAuth المميز لإعادة التحميل معرّفات العملاء التي يمكنك طلب البحث عنها في ReachPlanService. يُعلمك هذا الإجراء بعملية الدمج ويتم شرحه بالتفصيل في الأقسام التالية.

أرقام التعريف الشخصي IDs للعميل

تعمل معظم الخدمات ضِمن Google Ads API على حسابات وحملات معيّنة على "إعلانات Google". نتيجةً لذلك، تتطلّب معظم الطلبات توفّر رقم تعريف عميل لتحديد الحساب الذي تديره أو تستعلم عنه، بالإضافة إلى بيانات اعتماد OAuth التي تملك إذن الوصول إلى رقم تعريف العميل هذا. ومع ذلك، فإنّ ReachPlanService مخصّص لأنشطة تخطيط الفيديو التي قد تحدث قبل معرفة الرقم التعريفي المحدّد للعميل الذي ستُطلق فيه حملة.

الأدوات الداخلية

إذا كنت تنشئ أدوات للاستخدام الداخلي في مؤسستك، إليك بعض الاقتراحات.

المخطّطون الذين لا يمكنهم الوصول مباشرةً إلى حساب العميل

إذا لم يكن لدى مخطّطيك إذن بالوصول إلى حسابات "إعلانات Google" الخاصة بعملائك، يمكنك إنشاء بيانات اعتماد OAuth باستخدام مسار المصادقة للمستخدم الفردي لمستخدم لديه إذن بالوصول إلى حسابك الإداري. بعد ذلك، أنشئ حسابًا على "إعلانات Google" أو احصل على حساب لكل فريق يستخدم أداتك، ثم اربط هذه الحسابات بحسابك الإداري. عند تقديم طلبات إلى ReachPlanService، يجب تقديم معرّف العميل الذي يتوافق مع فريق المستخدم.

المخطّطون الذين يمكنهم الوصول إلى حساب العميل

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

الأدوات الخارجية

إذا كنت تنشئ أداة للمستخدمين الخارجيين، ننصحك باتّباع طرق مشابهة:

حسابات لكل عميل

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

إذن الوصول الذي يمنحه المستخدم

امنح المستخدمين إمكانية منح أداتك إذن الوصول إلى حساباتهم باستخدام مسار المصادقة المتعدّدة المستخدمين. بعد أن يمنح المستخدم الإذن، استخدِم CustomerService لتزويده بقائمة بحسابات "إعلانات Google" التي يمكنه الوصول إليها.

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

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

تعرّف على كيفية تحديد خطة إعلامية.