Method: changes.list

Bir kullanıcı veya ortak Drive ile ilgili 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. Belirtilen değişiklik kimlikleri, ortak Drive'ı yansıtır. Tanımlayıcı olarak birleştirilmiş Drive kimliğini ve değişiklik kimliğini kullanın.
includeCorpusRemovals

boolean

Bir dosya değişiklik listesinden kaldırılmış olsa ve bu dosya için başka değişiklik girişi olmayacak olsa bile, istek sırasında kullanıcının dosyaya erişimi varsa değişikliklerin dosya kaynağını içermesi gerekip gerekmediği.
includeDeleted

boolean

Öğelerin, silme veya erişim kaybı gibi nedenlerle değişiklik listesinden kaldırıldığını belirten değişikliklerin dahil edilip edilmeyeceği.
includeItemsFromAllDrives

boolean

Hem Drive'ım hem de ortak Drive'daki öğelerin sonuçlara dahil edilip edilmeyeceğini belirtir.
includeSubscribed

boolean

Drive'ım hiyerarşisinin dışındaki değişikliklerin sonuca dahil edilip edilmeyeceği. Yanlış olarak ayarlandığında, Uygulama Verileri klasöründeki veya Drive'ım'a eklenmemiş paylaşılan dosyalardaki değişiklikler sonuçtan çıkarılır.
includeTeamDriveItems
(deprecated)

boolean

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

integer

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

string

Önceki liste isteğine sonraki sayfada devam etmek için kullanılan jeton. Bu değer, önceki yanıttaki nextPageToken değerine veya getStartPageToken yönteminin yanıtına ayarlanmalıdır.
spaces

string

Sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler drive, appDataFolder ve photos'dir.
startChangeId
(deprecated)

string (int64 format)

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

boolean

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

boolean

Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
teamDriveId
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine driveId politikasını 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 etiketlerin virgülle ayrılmış kimlik listesi.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir 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

Değişikliklerin bir sonraki sayfası için sayfa jetonu. Değişiklikler listesinin sonuna ulaşıldıysa bu seçenek gösterilmez. Jeton herhangi bir nedenle reddedilirse atılmalıdır ve sayfalandırma, sonuçların ilk sayfasından yeniden başlatılmalıdır.
kind

string

Bu değer 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 doldurulmuşsa 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ıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.