Method: transfers.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca i trasferimenti per un cliente in base all'utente di origine, all'utente di destinazione o allo stato.
Richiesta HTTP
GET https://admin.googleapis.com/admin/datatransfer/v1/transfers
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
customerId |
string
ID immutabile dell'account Google Workspace.
|
maxResults |
integer
Il numero massimo di risultati da restituire. Il valore predefinito è 100.
|
newOwnerUserId |
string
L'ID profilo dell'utente di destinazione.
|
oldOwnerUserId |
string
L'ID profilo dell'utente di origine.
|
pageToken |
string
Token per specificare la pagina successiva nell'elenco.
|
status |
string
Stato del trasferimento.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Modello per una raccolta di risorse DataTransfer.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"kind": string,
"etag": string,
"dataTransfers": [
{
object (DataTransfer)
}
],
"nextPageToken": string
} |
| Campi |
kind |
string
Identifica la risorsa come una raccolta di richieste di trasferimento di dati.
|
etag |
string
ETag della risorsa.
|
dataTransfers[] |
object (DataTransfer)
transfers.list di richieste di trasferimento dati.
|
nextPageToken |
string
Token per specificare la pagina successiva nell'elenco.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/admin.datatransfer
https://www.googleapis.com/auth/admin.datatransfer.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-24 UTC.
[null,null,["Ultimo aggiornamento 2025-07-24 UTC."],[],[],null,["# Method: transfers.list\n\nLists the transfers for a customer by source user, destination user, or status.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/datatransfer/v1/transfers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------|----------------------------------------------------------------|\n| `customerId` | `string` Immutable ID of the Google Workspace account. |\n| `maxResults` | `integer` Maximum number of results to return. Default is 100. |\n| `newOwnerUserId` | `string` Destination user's profile ID. |\n| `oldOwnerUserId` | `string` Source user's profile ID. |\n| `pageToken` | `string` Token to specify the next page in the list. |\n| `status` | `string` Status of the transfer. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nTemplate for a collection of DataTransfer resources.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"dataTransfers\": [ { object (/workspace/admin/data-transfer/reference/rest/v1/transfers#DataTransfer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the resource as a collection of data transfer requests. |\n| `etag` | `string` ETag of the resource. |\n| `dataTransfers[]` | `object (`[DataTransfer](/workspace/admin/data-transfer/reference/rest/v1/transfers#DataTransfer)`)` transfers.list of data transfer requests. |\n| `nextPageToken` | `string` Token to specify the next page in the list. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.datatransfer`\n- `\n https://www.googleapis.com/auth/admin.datatransfer.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
