Authentication

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