Method: verificationCodes.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض المجموعة الحالية من رموز التحقّق الاحتياطية الصالحة للمستخدم المحدّد
طلب HTTP
GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
userKey |
string
لتحديد المستخدم في طلب واجهة برمجة التطبيقات يمكن أن تكون القيمة عنوان البريد الإلكتروني الرئيسي للمستخدم أو عنوان البريد الإلكتروني البديل أو رقم تعريف المستخدم الفريد.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
نموذج استجابة JSON لعملية إدراج رموز التحقّق في Directory API
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"kind": string,
"etag": string,
"items": [
{
object (VerificationCode)
}
]
} |
| الحقول |
kind |
string
نوع المورد يكون هذا الخيار دائمًا admin#directory#verificationCodesList.
|
etag |
string
علامة ETag للمورد
|
items[] |
object (VerificationCode)
قائمة بموارد رموز إثبات الملكية
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admin.directory.user.security
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
VerificationCode
تتيح لك Directory API عرض رموز التحقق الاحتياطية لمستخدم وإنشاءها وإبطالها.
| تمثيل JSON |
{
"userId": string,
"verificationCode": string,
"kind": string,
"etag": string
} |
| الحقول |
userId |
string
المعرّف الفريد غير الواضح للمستخدِم.
|
verificationCode |
string
رمز إثبات ملكية حالي للمستخدم لا يتم عرض رموز التحقق التي تم إلغاؤها أو استخدامها كجزء من النتيجة.
|
kind |
string
نوع المورد يكون هذا الخيار دائمًا admin#directory#verificationCode.
|
etag |
string
علامة ETag للمورد
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: verificationCodes.list\n\nReturns the current set of valid backup verification codes for the specified user.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `userKey` | `string` Identifies the user in the API request. The value can be the user's primary email address, alias email address, or unique user ID. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nJSON response template for list verification codes operation in Directory API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"items\": [ { object (/workspace/admin/directory/reference/rest/v1/verificationCodes/list#VerificationCode) } ] } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the resource. This is always `admin#directory#verificationCodesList`. |\n| `etag` | `string` ETag of the resource. |\n| `items[]` | `object (`[VerificationCode](/workspace/admin/directory/reference/rest/v1/verificationCodes/list#VerificationCode)`)` A list of verification code resources. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user.security`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nVerificationCode\n----------------\n\nThe Directory API allows you to view, generate, and invalidate backup verification codes for a user.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------|\n| ``` { \"userId\": string, \"verificationCode\": string, \"kind\": string, \"etag\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The obfuscated unique ID of the user. |\n| `verificationCode` | `string` A current verification code for the user. Invalidated or used verification codes are not returned as part of the result. |\n| `kind` | `string` The type of the resource. This is always `admin#directory#verificationCode`. |\n| `etag` | `string` ETag of the resource. |"]]
