Method: transfers.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hier werden die Übertragungen für einen Kunden nach Quellnutzer, Zielnutzer oder Status aufgelistet.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/datatransfer/v1/transfers
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
customerId |
string
Die unveränderliche ID des Google Workspace-Kontos.
|
maxResults |
integer
Maximale Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 100.
|
newOwnerUserId |
string
Die Profil-ID des Zielnutzers.
|
oldOwnerUserId |
string
Die Profil-ID des Quellnutzers.
|
pageToken |
string
Token, mit dem die nächste Seite in der Liste angegeben wird.
|
status |
string
Status der Übertragung.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Vorlage für eine Sammlung von DataTransfer-Ressourcen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"kind": string,
"etag": string,
"dataTransfers": [
{
object (DataTransfer)
}
],
"nextPageToken": string
} |
| Felder |
kind |
string
Identifiziert die Ressource als Sammlung von Datenübertragungsanfragen.
|
etag |
string
ETag der Ressource.
|
dataTransfers[] |
object (DataTransfer)
transfers.list mit Datenübertragungsanfragen
|
nextPageToken |
string
Token, mit dem die nächste Seite in der Liste angegeben wird.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/admin.datatransfer
https://www.googleapis.com/auth/admin.datatransfer.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-24 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
