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