Method: changes.getStartPageToken
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
صفحه شروع توکن را برای فهرست کردن تغییرات آینده دریافت می کند. برای اطلاعات بیشتر، به بازیابی تغییرات مراجعه کنید.
درخواست HTTP
GET https://www.googleapis.com/drive/v3/changes/startPageToken
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
driveId | string شناسه درایو مشترک که صفحه شروع توکن برای فهرست کردن تغییرات آتی از آن درایو مشترک برای آن بازگردانده خواهد شد. |
supportsAllDrives | boolean اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند. |
supportsTeamDrives
(deprecated) | boolean منسوخ شده: به جای آن از supportsAllDrives استفاده کنید. |
teamDriveId
(deprecated) | string منسوخ شده: به جای آن از driveId استفاده کنید. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"startPageToken": string,
"kind": string
} |
| فیلدها |
|---|
startPageToken | string نشانه صفحه شروع برای فهرست کردن تغییرات آینده. توکن صفحه منقضی نمی شود. |
kind | string مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "drive#startPageToken" . |
محدوده مجوز
به یکی از حوزه های 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: changes.getStartPageToken\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.StartPageToken.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets the starting pageToken for listing future changes. 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/startPageToken`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| `driveId` | `string` The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned. |\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------|\n| ``` { \"startPageToken\": string, \"kind\": string } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------|\n| `startPageToken` | `string` The starting page token for listing future changes. The page token doesn't expire. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#startPageToken\"`. |\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)."]]
