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