Authentication

يجب أن تتضمّن الطلبات الموجّهة إلى ReachPlanService الرمز المميز للمطوِّر المعتمَد وبيانات اعتماد OAuth ورقم تعريف العميل الذي يمكن لبيانات اعتماد OAuth الوصول إليه.

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

الرمز المميز للمطوّر وبيانات اعتماد OAuth

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

1. يجب إضافة الرمز المميز للمطوّر إلى قائمة السماح المناسبة للربط بـ 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. قبل دمج واجهة برمجة التطبيقات، اختَر أحد الأسلوبَين وفقًا لحالتك وحدِّد بعض معرّفات العملاء لاختبارها. إذا لم تكن متأكدًا، استخدِم الطريقة الأولى المقترَحة لنوع أداتك.

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

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