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