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