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