Method: mobiledevices.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir hesaptaki kullanıcıya ait tüm mobil cihazların sayfalandırılmış listesini alır. Şirkete ait cihazları içeren bir liste almak için bunun yerine Cloud Identity Devices API'yi kullanın. Bu yöntem 60 dakika sonra zaman aşımına uğrar. Daha fazla bilgi için Hata kodlarıyla ilgili sorunları giderme başlıklı makaleyi inceleyin.
HTTP isteği
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
customerId |
string
Müşterinin Google Workspace hesabının benzersiz kimliği. Hesap yöneticisi olarak, hesabınızın customerId değerini temsil etmek için my_customer takma adını da kullanabilirsiniz. customerId , Users kaynağı kapsamında da döndürülür.
|
Sorgu parametreleri
Parametreler |
maxResults |
integer
Döndürülecek maksimum sonuç sayısı. İzin verilen maksimum değer 100'dür.
|
orderBy |
enum (OrderBy )
Sonuçları sıralamak için kullanılacak cihaz özelliği.
|
pageToken |
string
Listede sonraki sayfayı belirtmek için jeton
|
projection |
enum (Projection )
Seçilen alan grubuna döndürülen bilgileri kısıtlayın.
|
query |
string
https://developers.google.com/workspace/admin/directory/v1/search-operators adresinde verilen biçimdeki arama dizesi
|
sortOrder |
enum (SortOrder )
Sonuçların artan düzende mi yoksa azalan düzende mi döndürüleceğini belirtir. orderBy parametresi ile kullanılmalıdır.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"kind": string,
"etag": string,
"mobiledevices": [
{
object (MobileDevice )
}
],
"nextPageToken": string
} |
Alanlar |
kind |
string
Bu kaynağın türü.
|
etag |
string
Kaynağın ETag'i.
|
mobiledevices[] |
object (MobileDevice )
Mobil Cihaz nesnelerinin listesi.
|
nextPageToken |
string
Bu sonucun bir sonraki sayfasına erişmek için kullanılan jeton.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/admin.directory.device.mobile
https://www.googleapis.com/auth/admin.directory.device.mobile.action
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Şuna göre sırala
Sıralamalar |
DEVICE_ID |
Google Sync mobil cihazın seri numarası. Android cihazlarda bu, yazılım tarafından oluşturulan benzersiz bir tanımlayıcıdır. |
EMAIL |
Cihaz sahibinin e-posta adresi. |
LAST_SYNC |
Cihazın son politika ayarları senkronizasyon tarihi ve saati. |
MODEL |
Mobil cihazın modeli. |
NAME |
Cihaz sahibinin kullanıcı adı. |
OS |
Cihazın işletim sistemi. |
STATUS |
Cihaz durumu. |
TYPE |
Cihazın türü. |
Projeksiyon
Sıralamalar |
BASIC |
Yalnızca temel meta veri alanlarını (ör.deviceId, model, durum, tür ve durum) içerir. |
FULL |
Tüm meta veri alanlarını içerir |
SortOrder
Sıralamalar |
ASCENDING |
Artan düzen. |
DESCENDING |
Azalan düzen. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: mobiledevices.list\n\nRetrieves a paginated list of all user-owned mobile devices for an account. To retrieve a list that includes company-owned devices, use the Cloud Identity [Devices API](https://cloud.google.com/identity/docs/concepts/overview-devices) instead. This method times out after 60 minutes. For more information, see [Troubleshoot error codes](https://developers.google.com/workspace/admin/directory/v1/guides/troubleshoot-error-codes).\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of results to return. Max allowed value is 100. |\n| `orderBy` | `enum (`[OrderBy](/workspace/admin/directory/reference/rest/v1/mobiledevices/list#OrderBy)`)` Device property to use for sorting results. |\n| `pageToken` | `string` Token to specify next page in the list |\n| `projection` | `enum (`[Projection](/workspace/admin/directory/reference/rest/v1/mobiledevices/list#Projection)`)` Restrict information returned to a set of selected fields. |\n| `query` | `string` Search string in the format given at \u003chttps://developers.google.com/workspace/admin/directory/v1/search-operators\u003e |\n| `sortOrder` | `enum (`[SortOrder](/workspace/admin/directory/reference/rest/v1/mobiledevices/list#SortOrder)`)` Whether to return results in ascending or descending order. Must be used with the `orderBy` parameter. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"mobiledevices\": [ { object (/workspace/admin/directory/reference/rest/v1/mobiledevices#MobileDevice) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Kind of resource this is. |\n| `etag` | `string` ETag of the resource. |\n| `mobiledevices[]` | `object (`[MobileDevice](/workspace/admin/directory/reference/rest/v1/mobiledevices#MobileDevice)`)` A list of Mobile Device objects. |\n| `nextPageToken` | `string` Token used to access next page of this result. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.directory.device.mobile`\n- `\n https://www.googleapis.com/auth/admin.directory.device.mobile.action`\n- `\n https://www.googleapis.com/auth/admin.directory.device.mobile.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nOrderBy\n-------\n\n| Enums ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------|\n| `DEVICE_ID` | The serial number for a Google Sync mobile device. For Android devices, this is a software generated unique identifier. |\n| `EMAIL` | The device owner's email address. |\n| `LAST_SYNC` | Last policy settings sync date time of the device. |\n| `MODEL` | The mobile device's model. |\n| `NAME` | The device owner's user name. |\n| `OS` | The device's operating system. |\n| `STATUS` | The device status. |\n| `TYPE` | Type of the device. |\n\nProjection\n----------\n\n| Enums ||\n|---------|-------------------------------------------------------------------------------------------|\n| `BASIC` | Includes only the basic metadata fields (e.g., deviceId, model, status, type, and status) |\n| `FULL` | Includes all metadata fields |\n\nSortOrder\n---------\n\n| Enums ||\n|--------------|-------------------|\n| `ASCENDING` | Ascending order. |\n| `DESCENDING` | Descending order. |"]]