Method: changes.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه السمة التغييرات التي أجراها مستخدم أو مساحة Drive مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على استرداد التغييرات.
طلب HTTP
GET https://www.googleapis.com/drive/v3/changes
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
driveId |
string
مساحة التخزين السحابي المشتركة التي سيتم عرض التغييرات منها. في حال تحديد المعرّفات، ستعكس التغييرات مساحة التخزين السحابي المشتركة، لذا استخدِم معرّف مساحة التخزين السحابي المدمج ومعرّف التغيير كمعرّف.
|
includeCorpusRemovals |
boolean
تحديد ما إذا كان يجب أن تتضمّن التغييرات مورد الملف إذا كان المستخدم لا يزال بإمكانه الوصول إلى الملف في وقت الطلب، حتى عندما تتم إزالة ملف من قائمة التغييرات ولن تكون هناك إدخالات تغيير أخرى لهذا الملف
|
includeItemsFromAllDrives |
boolean
تحديد ما إذا كان يجب تضمين عناصر "ملفاتي" ومساحة التخزين السحابي المشتركة في النتائج
|
includeRemoved |
boolean
تحديد ما إذا كان سيتم تضمين التغييرات التي تشير إلى أنّه تمت إزالة عناصر من قائمة التغييرات، مثلاً عن طريق الحذف أو فقدان إذن الوصول
|
includeTeamDriveItems
(deprecated) |
boolean
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة includeItemsFromAllDrives بدلاً منها.
|
pageSize |
integer
الحدّ الأقصى لعدد التغييرات التي سيتم عرضها في كل صفحة
|
pageToken |
string
الرمز المميز لمواصلة طلب قائمة سابق في الصفحة التالية يجب ضبط هذه السمة على قيمة nextPageToken من الاستجابة السابقة أو على الاستجابة من طريقة getStartPageToken.
|
restrictToMyDrive |
boolean
تحديد ما إذا كان سيتم حصر النتائج على التغييرات داخل التسلسل الهرمي لـ "ملفاتي" يستثني ذلك التغييرات التي تطرأ على الملفات، مثل تلك الموجودة في مجلد "بيانات التطبيقات" أو الملفات المشترَكة التي لم تتم إضافتها إلى "ملفاتي".
|
spaces |
string
قائمة مفصولة بفواصل تتضمّن المساحات المطلوب البحث فيها ضمن مجموعات النصوص القيمتان المسموح بهما هما "drive" و"appDataFolder".
|
supportsAllDrives |
boolean
تحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة
|
supportsTeamDrives
(deprecated) |
boolean
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
|
teamDriveId
(deprecated) |
string
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة driveId بدلاً منها.
|
includePermissionsForView |
string
تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح بالقيمة "منشور" فقط.
|
includeLabels |
string
قائمة مفصولة بفواصل تتضمّن معرّفات التصنيفات المطلوب تضمينها في الجزء labelInfo من الردّ.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بالتغييرات التي أجراها مستخدم
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"changes": [
{
object (Change)
}
],
"kind": string,
"nextPageToken": string,
"newStartPageToken": string
} |
| الحقول |
changes[] |
object (Change)
قائمة التغييرات إذا تم ملء nextPageToken، قد تكون هذه القائمة غير مكتملة ويجب استرداد صفحة إضافية من النتائج.
|
kind |
string
تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#changeList".
|
nextPageToken |
string
الرمز المميز للصفحة التالية من التغييرات. لن يظهر هذا الخيار إذا تم الوصول إلى نهاية قائمة التغييرات. لا تنتهي صلاحية رمز الصفحة المميز.
|
newStartPageToken |
string
الرمز المميز لصفحة البدء للتغييرات المستقبلية. لن يظهر هذا الخيار إلا إذا تم الوصول إلى نهاية قائمة التغييرات الحالية. لا تنتهي صلاحية رمز الصفحة المميز.
|
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتتمكّن من استخدامها في تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: changes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ChangeList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the changes for a user or shared drive. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/changes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `driveId` | `string` The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. |\n| `includeCorpusRemovals` | `boolean` Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. |\n| `includeItemsFromAllDrives` | `boolean` Whether both My Drive and shared drive items should be included in results. |\n| `includeRemoved` | `boolean` Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access. |\n| `includeTeamDriveItems` **(deprecated)** | `boolean` Deprecated: Use `includeItemsFromAllDrives` instead. |\n| `pageSize` | `integer` The maximum number of changes to return per page. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method. |\n| `restrictToMyDrive` | `boolean` Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive. |\n| `spaces` | `string` A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `teamDriveId` **(deprecated)** | `string` Deprecated: Use `driveId` instead. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only 'published' is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of changes for a user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"changes\": [ { object (/workspace/drive/api/reference/rest/v3/changes#Change) } ], \"kind\": string, \"nextPageToken\": string, \"newStartPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `changes[]` | `object (`[Change](/workspace/drive/api/reference/rest/v3/changes#Change)`)` The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#changeList\"`. |\n| `nextPageToken` | `string` The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire. |\n| `newStartPageToken` | `string` The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
