Method: users.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد جميع المستخدمين الذين لديهم إذن الوصول إلى حساب المطوِّر.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=developers/*}/users
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. حساب المطوّر المطلوب جلب المستخدمين منه التنسيق: developers/{developer}
|
معامِلات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد النتائج المطلوب عرضها. يجب ضبط هذه القيمة على -1 لإيقاف التقسيم على صفحات.
|
pageToken |
string
رمز مميز تم استلامه من استدعاء سابق لهذه الطريقة، لاسترداد المزيد من النتائج.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ يحتوي على مستخدم واحد أو أكثر لديهم إذن الوصول إلى حساب
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"users": [
{
object (User )
}
],
"nextPageToken": string
} |
الحقول |
users[] |
object (User )
المستخدمون الناتجون.
|
nextPageToken |
string
رمز مميز يتم تمريره إلى الطلبات اللاحقة لاسترداد النتائج اللاحقة. لن يتم تعيين هذا إذا لم تكن هناك نتائج أخرى لعرضها.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists all users with access to a specified developer account.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eAccepts optional query parameters for pagination: \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of users (\u003ccode\u003eUser\u003c/code\u003e objects) and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving further results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and the endpoint uses a \u003ccode\u003eGET\u003c/code\u003e request.\u003c/p\u003e\n"]]],["This document details the process for retrieving a list of users with access to a developer account via the Android Publisher API. The `GET` request is sent to a specific URL, including the developer account ID in the path. It uses parameters `pageSize` and `pageToken` for pagination. The request body is empty. The response contains a list of `users` and, if applicable, a `nextPageToken` for subsequent data retrieval. Authorization requires the `androidpublisher` OAuth scope.\n"],null,["# Method: users.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListUsersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all users with access to a developer account.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=developers/*}/users`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The developer account to fetch users from. Format: developers/{developer} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results to return. This must be set to -1 to disable pagination. |\n| `pageToken` | `string` A token received from a previous call to this method, in order to retrieve further results. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response containing one or more users with access to an account.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------|\n| ``` { \"users\": [ { object (/android-publisher/api-ref/rest/v3/users#User) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `users[]` | `object (`[User](/android-publisher/api-ref/rest/v3/users#User)`)` The resulting users. |\n| `nextPageToken` | `string` A token to pass to subsequent calls in order to retrieve subsequent results. This will not be set if there are no more results to return. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]