Method: changes.list

Bir kullanıcı veya ortak Drive'daki değişiklikleri listeler.

HTTP isteği

GET https://www.googleapis.com/drive/v2/changes

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
driveId

string

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

boolean

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.

includeDeleted

boolean

Öğelerin değişiklik listesinden kaldırıldığını (ör. silme veya erişim kaybı) gösteren değişikliklerin eklenip eklenmeyeceğini belirtir.

includeItemsFromAllDrives

boolean

Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği.

includeSubscribed

boolean

Sonuca Drive'ım hiyerarşisi dışındaki değişikliklerin dahil edilip edilmeyeceğini belirler. Bu politika yanlış değerine ayarlandığında, Uygulama Verileri klasöründekiler veya Drive'ım bölümüne eklenmemiş paylaşılan dosyalar gibi dosyalarda yapılan değişiklikler sonuçtan çıkarılır.

includeTeamDriveItems
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine includeItemsFromAllDrives kullanın.

maxResults

integer

Döndürülecek maksimum değişiklik sayısı.

pageToken

string

Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, önceki yanıttaki nextPageToken değerine veya getStartPageToken yöntemindeki yanıta ayarlanmalıdır.

spaces

string

Sorgulanacak alanların virgülle ayrılmış listesi. drive, appDataFolder ve photos değerleri desteklenir.

startChangeId
(deprecated)

string (int64 format)

Desteği sonlandırıldı: Bunun yerine pageToken kullanın.

supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'ım klasörlerini hem de ortak drive'ları destekleyip desteklemediği.

supportsTeamDrives
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine supportsAllDrives kullanın.

teamDriveId
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine driveId kullanın.

includePermissionsForView

string

Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.

includeLabels

string

Yanıtın labelInfo bölümüne dahil edilecek etiket kimliklerinin virgülle ayrılmış listesi.

İ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
{
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Change)
    }
  ]
}
Alanlar
largestChangeId

string (int64 format)

Mevcut en büyük değişiklik kimliği.

nextPageToken

string

Bir sonraki değişiklik sayfası için sayfa jetonu. Değişiklik listesinin sonuna ulaşıldıysa bu dosya eksik olacaktır. Jeton herhangi bir nedenle reddedilirse silinmeli ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır.

kind

string

Bu her zaman drive#changeList.

etag

string

Listenin ETag'i.

newStartPageToken

string

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.

items[]

object (Change)

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/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

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.