Method: changes.getStartPageToken
صفحه شروع توکن را برای فهرست کردن تغییرات آینده دریافت می کند.
درخواست HTTP
GET https://www.googleapis.com/drive/v2/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/docs -
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.appdata -
https://www.googleapis.com/auth/drive.apps.readonly -
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-01-10 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی."],[[["This API retrieves the starting page token required to list future changes in Google Drive, including within shared drives."],["The request body should be empty, while the response includes the `startPageToken` and a resource identifier (`kind`)."],["Several authorization scopes are available, ranging from full Drive access (`drive`) to read-only metadata permissions (`drive.metadata.readonly`), with some requiring a security assessment."],["Optional query parameters allow specifying a specific shared drive (`driveId`) and declaring support for My Drives and shared drives (`supportsAllDrives`)."],["You can find the endpoint URL and detailed parameter descriptions within the documentation to implement this functionality."]]],["This document details how to retrieve a starting page token for listing changes via a `GET` HTTP request to `https://www.googleapis.com/drive/v2/changes/startPageToken`. The request, with an empty body, may include `driveId` and `supportsAllDrives` query parameters. The response contains `startPageToken` and `kind` fields, formatted in JSON. Various OAuth scopes are required for authorization, such as `https://www.googleapis.com/auth/drive`. Deprecated parameters `supportsTeamDrives` and `teamDriveId` should not be used.\n"]]
