Method: transfers.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
依來源使用者、目的地使用者或狀態,列出客戶的轉移作業。
HTTP 要求
GET https://admin.googleapis.com/admin/datatransfer/v1/transfers
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
customerId |
string
Google Workspace 帳戶的不可變 ID。
|
maxResults |
integer
要傳回的結果數上限。預設值為 100。
|
newOwnerUserId |
string
目的地使用者的個人資料 ID。
|
oldOwnerUserId |
string
來源使用者的設定檔 ID。
|
pageToken |
string
用於指定清單中下一頁的符記。
|
status |
string
轉移狀態。
|
回應主體
DataTransfer 資源集合的範本。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"kind": string,
"etag": string,
"dataTransfers": [
{
object (DataTransfer )
}
],
"nextPageToken": string
} |
欄位 |
kind |
string
將資源識別為一組資料移轉要求。
|
etag |
string
資源的 ETag。
|
dataTransfers[] |
object (DataTransfer )
資料轉移要求的 transfers.list。
|
nextPageToken |
string
用於指定清單中下一頁的符記。
|
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/admin.datatransfer
https://www.googleapis.com/auth/admin.datatransfer.readonly
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-24 (世界標準時間)。
[null,null,["上次更新時間:2025-07-24 (世界標準時間)。"],[],[],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)."]]