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