تُجري Google مكالمات مع نقاط نهاية OAuth2 أثناء عملية ربط الحساب. قد يتعذّر إجراء هذه المكالمات لأسباب مختلفة. يتم تسجيل المعلومات التفصيلية لهذه الأخطاء ويمكنك مراقبتها في صفحة مستكشف السجلات بمشروع وحدة التحكم في السحابة الإلكترونية.
الفلترة بحثًا عن أخطاء ربط الحساب
في صفحة مستكشف السجلات، اضبط فلاتر طلب البحث على ما يلي، ثم انقر على الزر تشغيل طلب البحث:
- المورد: اختَر مشروع إجراءات "مساعد Google" إذا كنت قد أنشأت المشروع من خلال Actions on Google Console، أو اختَر Google Project.
- اسم السجلّ: حدّد الخيار ربط حساب Google.
- درجة الخطورة: تم ضبطها على error (خطأ)، ويتم تصنيف جميع إدخالات ربط الحساب على أنها أخطاء.
يمكنك أيضًا الفلترة حسب التاريخ من خلال تعديل النطاق الزمني في أعلى صفحة "مستكشف السجلات"، كما هو موضّح في لقطة الشاشة التالية:
الشكل 1. فلاتر طلبات بحث مستكشف السجلات
يمكنك العثور على مزيد من المعلومات عن كيفية استخدام "مستكشف السجلات" في وثائق مستكشف السجلات.
محتوى بيانات الخطأ
يتم تضمين بيانات أخطاء ربط الحساب في السمة jsonPayload من إدخال الخطأ. وتشمل البيانات الحقول التالية:
@type(String): يتم ضبطها دائمًا علىtype.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.step(String): خطوة الربط التي حدث فيها الخطأ. اضبط إحدى القيم التالية:ACCOUNT_LINKING_STEP_UNDEFINED: خطوة غير محدّدة.AUTH_CODE_EXCHANGE: خطوة تبادل رمز المصادقة للوصول إلى الرمز المميّز أو إعادة تحميلهREFRESH_ACCESS_TOKEN: خطوة إعادة تحميل رمز الدخولTOKEN_REVOCATION: خطوة إبطال رمز مميّزUSERINFO: خطوة جلب معلومات المستخدم باستخدام رمز دخول.ASSERTION: خطوة إنشاء رابط عن طريق التأكيد
response(String, optional): تمثّل استجابة HTTP:status: حالة استجابة HTTP.body: وصف الخطأ وسلسلة الخطأ
request(String, optional): تمثّل طلب HTTP ويحتوي على معلَمات طلب HTTP التالية: الطريقة ونص الرسالة ومعرّف الموارد المنتظم (URI) والعناوين.
الحقلان request وresponse اختياريان لأنه يتم أحيانًا الفصل بين إدخالَين مختلفَين في عارض السجلّ.
وعند تنفيذ خادم بروتوكول OAuth لربط حساب Google وخادم OAuth لربط Google بسلاسة، يلزمك استخدام رموز استجابة HTTP محددة لحالات مختلفة. يجب أن تتوافق القيم التي تعرضها مع الحالة الصحيحة الواردة في المستندات.