المصادقة

ملاحظة مهمة: لا تتوفّر هذه الميزة إلا للحسابات المُدرَجة في القائمة المسموح بها. يُرجى التواصل مع ممثل عن Google إذا كنت بحاجة إلى الوصول إلى الميزة.

يجب أن توفّر الطلبات إلى ReachPlanService رمزًا مميزًا للمطوِّر معتمَدًا وبيانات اعتماد OAuth ورقم تعريف للعميل يمكن لبيانات اعتماد OAuth الوصول إليه.

يتناول هذا الدليل تفاصيل المصادقة الخاصة بخدمة ReachPlanService. إذا لم يسبق لك ذلك، أكمِل الخطوات الموضّحة في البدء أولاً، ثم ارجِع إلى هذه النقطة.

الرمز المميز للمطوِّر وبيانات اعتماد OAuth

بالإضافة إلى الإرشادات التي تقدّمها منصة البدء، يُرجى مراعاة النقاط التالية:

1. يجب إدراج الرمز المميّز للمطوِّر في القائمة المسموح بها لربطه بـ ReachPlanService، حتى إذا سبق أن تمت الموافقة على استخدامه مع خدمات Google Ads API الأخرى. لمزيد من المعلومات، راجع متطلبات الأهلية.
2. يجب قبول بنود خدمة Google Ads API للربط بـ Google Ads API.
3. يحدّد المستخدم الذي يملك الرمز المميّز لإعادة تحميل OAuth الأرقام التعريفية للعملاء التي يمكنك طلبها في ReachPlanService. سيكون ذلك مفيدًا في عملية الدمج، ويتم توضيحه بمزيد من التفاصيل أدناه.

أرقام التعريف الشخصي IDs للعميل

تعمل معظم الخدمات ضمن Google Ads API على حسابات وحملات معيّنة في "إعلانات Google". ونتيجةً لذلك، تتطلب معظم الطلبات كلاً من الرقم التعريفي للعميل لتحديد الحساب الذي تديره أو طلب البحث عنه، وبيانات اعتماد OAuth التي لديها إذن بالوصول إلى معرّف العميل هذا. ومع ذلك، فإنّ ReachPlanService مخصّصة لأنشطة التخطيط للفيديو التي قد تحدث قبل أن تعرف الرقم التعريفي للعميل المحدد حيث يمكنك عرض الحملة.

بالنسبة إلى الشركاء الذين ينشئون أدوات للاستخدام الداخلي في مؤسساتهم، ننصح باتّباع أحد الخيارات التالية:

1. إذا لم يكن بإمكان المخطِّطين الوصول إلى حسابات عملائك على "إعلانات Google": يمكنك إنشاء بيانات اعتماد OAuth باستخدام مسار التطبيقات المثبَّت لمستخدم لديه إذن وصول إلى الحساب الإداري للرمز المميّز للمطوِّر. بعد ذلك، أنشئ حسابًا على "إعلانات Google" أو احصل عليه لكل فريق يستخدم أداتك، واربطه بحسابك الإداري. وعند تقديم طلبات إلى ReachPlanService، قدِّم الرقم التعريفي للعميل يتوافق مع فريق المستخدم.

2. إذا كان لدى المخطِّطين إذن الوصول إلى حساب إداري على "إعلانات Google" يدير حسابات عملائك: يمكنك تنفيذ خطوات تطبيق الويب للسماح للتطبيق باستخدام بيانات اعتماد OAuth للمخطِّطين. وبعد ذلك يمكنك تمرير الرقم التعريفي للعميل المقابل لعميل خطتك.

بالنسبة إلى الشركاء الذين ينشئون أداة للمستخدمين الخارجيين، ننصح بأساليب مشابهة:

1. أنشئ بيانات اعتماد OAuth باستخدام خطوات التطبيقات المثبَّتة لمستخدم يمكنه الوصول إلى الحساب الإداري للرمز المميز للمطوِّر. أنشئ حسابًا على "إعلانات Google" لكل عميل خارجي واربطه بحسابك الإداري. بعد ذلك، اضبط أداتك لتقديم الرقم التعريفي للعميل المقابل للعميل عند إنشاء الخطط.

2. امنح المستخدمين القدرة على منح أداتك الإذن بالوصول إلى حساباتهم باستخدام تدفق تطبيق الويب. بعد أن يمنح المستخدم الإذن، استخدِم CustomerService لتزويده بقائمة بحسابات "إعلانات Google" التي يمكنه الوصول إليها.

الهدف هو ضمان حصول المخطِّطين على أقل الصعوبات الممكنة عند استخدام ReachPlanService. قبل دمج واجهة برمجة التطبيقات، اختر أحد الخيارين وفقًا لحالتك وحدد بعض أرقام تعريف العملاء لاختبارها. إذا لم تكن متأكّدًا، استخدِم النهج المقترَح الأول لنوع الأداة الذي تستخدمه.