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