Bir kullanıcı veya ortak Drive'daki değişiklikleri listeler.
HTTP isteği
GET https://www.googleapis.com/drive/v3/changes
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
driveId |
Değişikliklerin döndürüleceği ortak Drive. Belirtilmişse değişiklik kimlikleri ortak Drive'ı yansıtır; tanımlayıcı olarak birleştirilmiş Drive kimliği ve değişiklik kimliğini kullanın. |
includeCorpusRemovals |
Dosya istek sırasında kullanıcı tarafından dosyaya hâlâ erişilebiliyorsa, bir dosya değişiklik listesinden kaldırılmış ve bu dosya için başka değişiklik girişi yapılmayacak olsa bile değişikliklerin dosya kaynağını içerip içermeyeceği. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği. |
includeRemoved |
Öğelerin değişiklik listesinden kaldırıldığını (ör. silme veya erişim kaybı) gösteren değişikliklerin eklenip eklenmeyeceğini belirtir. |
includeTeamDriveItems |
Desteği sonlandırıldı: Bunun yerine |
pageSize |
Sayfa başına döndürülecek maksimum değişiklik sayısı. |
pageToken |
Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, "nextPageToken" değerine ayarlanmalıdır. veya getStartPageToken yönteminden gelen yanıta yazabilirsiniz. |
restrictToMyDrive |
Sonuçların Drive'ım hiyerarşisindeki değişikliklerle kısıtlanıp kısıtlanmayacağı. Bu seçenekte, Uygulama Verileri klasöründekiler veya Drive'ım bölümüne eklenmemiş paylaşılan dosyalar gibi dosyalarda yapılan değişiklikler dahil edilmez. |
spaces |
Şirket içinde sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler: "drive" ve "appDataKlasör". |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'ım klasörlerini hem de ortak drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Desteği sonlandırıldı: Bunun yerine |
teamDriveId |
Desteği sonlandırıldı: Bunun yerine |
includePermissionsForView |
Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" desteklenir. |
includeLabels |
Yanıtın |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Kullanıcıyla ilgili değişikliklerin listesi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"kind": string,
"nextPageToken": string,
"newStartPageToken": string,
"changes": [
{
object ( |
Alanlar | |
---|---|
kind |
Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit |
nextPageToken |
Bir sonraki değişiklik sayfası için sayfa jetonu. Değişiklik listesinin sonuna ulaşıldıysa bu dosya eksik olacaktır. Sayfa jetonunun süresi dolmaz. |
newStartPageToken |
Gelecekteki değişiklikler için başlangıç sayfası jetonu. Bu menü yalnızca mevcut değişiklikler listesinin sonuna ulaşıldıysa görünür. Sayfa jetonunun süresi dolmaz. |
changes[] |
Değişikliklerin listesi. nextPageToken doldurulursa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.