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. Bir tanımlayıcı olarak birleşik Drive kimliğini ve değişiklik kimliğini kullanın.
includeCorpusRemovals

boolean

Dosya değişiklik listesinden kaldırılmış olsa ve dosyada başka değişiklik girişi olmayacaksa bile istek sırasında kullanıcı dosyaya hâlâ erişebiliyorsa değişikliklerin dosya kaynağını içerip içermeyeceğini belirtir.
includeDeleted

boolean

Öğelerin değişiklik listesinden kaldırıldığını belirten değişikliklerin (ör. silme veya erişim kaybı) 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 ayarlanırsa, Uygulama Verileri klasöründekiler veya paylaşılan dosyalar gibi, Drive'ım bölümüne eklenmemiş dosyalarda yapılan değişiklikler sonuçtan çıkarılır.
includeTeamDriveItems
(deprecated)

boolean

Kullanımdan kaldırıldı: Bunun yerine includeItemsFromAllDrives kullanın.
maxResults

integer

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

string

Sonraki sayfada önceki liste isteğine devam etmek için kullanılan jeton. Bu, önceki yanıtın nextPageToken değerine veya getStartPageToken yönteminden alınan 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)

Kullanımdan kaldırıldı: Bunun yerine pageToken kullanın.
supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'larım hem de ortak Drive'ları destekleyip desteklemediği.
supportsTeamDrives
(deprecated)

boolean

Kullanımdan kaldırıldı: Bunun yerine supportsAllDrives kullanın.
teamDriveId
(deprecated)

string

Kullanımdan kaldırıldı: Bunun yerine driveId kullanın.
includePermissionsForView

string

Yanıta hangi ek görünüm 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

Sonraki değişiklik sayfasının sayfa jetonu. Değişiklik listesinin sonuna ulaşıldıysa bu öğe bulunmaz. Jeton herhangi bir nedenle reddedilirse silinir ve sayfalara ayırma işlemi ilk sonuç sayfasından yeniden başlatılmalıdır.
kind

string

Bu her zaman drive#changeList olur.
etag

string

Listenin ETag.
newStartPageToken

string

Gelecekteki değişiklikler için başlangıç sayfası jetonu. Bu seçenek yalnızca mevcut değişiklikler listesinin sonuna ulaşıldığında gösterilir.
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.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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.