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