يشرح هذا الدليل كيفية الوصول إلى Google Ads API باستخدام مصادقة المستخدم. يمكنك الاطّلاع على دليل النظرة العامة لمعرفة المزيد حول خيارات المصادقة المتاحة.
يستخدم سير عمل مصادقة المستخدم مسار OAuth 2.0 للحصول على إذن من المستخدم، ما يتيح لتطبيقك إدارة حسابات "إعلانات Google" نيابةً عن المستخدمين. بعد أن يكمل المستخدم عملية التفويض، يصدر خادم التفويض رمز دخول OAuth 2.0. يستخدم تطبيقك رمز الدخول هذا لإجراء طلبات بيانات من واجهة برمجة التطبيقات إلى حساب المستخدم على "إعلانات Google".
بما أنّ رموز الدخول عبر بروتوكولات OAuth 2.0 تنتهي صلاحيتها بعد ساعة واحدة، اطلب إذن الوصول غير المتصل بالإنترنت عبر بروتوكولات OAuth 2.0. يوفّر الوصول بلا إنترنت رمزًا مميزًا لإعادة التحميل يتيح لتطبيقك إنشاء رموز مميزة جديدة للوصول تلقائيًا بدون الحاجة إلى تفاعل متكرّر من المستخدم.
اختيار استراتيجية مصادقة
يمكنك تنفيذ سير عمل مصادقة المستخدم بإحدى الطريقتَين التاليتَين:
- مصادقة مستخدم واحد: يُنصح بها عندما يكون حساب مستخدم واحد لديه إذن الوصول إلى جميع حسابات "إعلانات Google" التي يحتاج تطبيقك إلى إدارتها. استخدِم مصادقة المستخدم الفردي كبديل لسير عمل حساب الخدمة عندما تمنعك سياسات المؤسسة أو إعدادات الحساب من استخدام حسابات الخدمة.
- المصادقة المتعدّدة المستخدمين: يُنصح بها عندما يدير تطبيقك حسابات يملكها عدة مستخدمين مختلفين. يتطلّب هذا الأسلوب إنشاء مسار OAuth 2.0 يتيح لكل مستخدم إجراء المصادقة بشكل فردي.
الخطوات التالية
- سير عمل المصادقة للمستخدم الفردي
- سير عمل مصادقة تعدد المستخدمين
- متطلبات الأمان الخاصة بمصادقة المستخدم