Method: transfers.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه السمة عمليات النقل الخاصة بالعميل حسب المستخدم المصدر أو المستخدم الوجهة أو الحالة.
طلب HTTP
GET https://admin.googleapis.com/admin/datatransfer/v1/transfers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
customerId |
string
رقم تعريف غير قابل للتغيير لحساب Google Workspace
|
maxResults |
integer
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. القيمة التلقائية هي 100.
|
newOwnerUserId |
string
رقم تعريف الملف الشخصي للمستخدم المستلِم
|
oldOwnerUserId |
string
رقم تعريف الملف الشخصي للمستخدم المصدر
|
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 of data transfer requests.
|
nextPageToken |
string
رمز مميّز لتحديد الصفحة التالية في القائمة
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/admin.datatransfer
https://www.googleapis.com/auth/admin.datatransfer.readonly
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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)."]]
