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. Belirtilmişse 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

Dosya, istek sırasında kullanıcı tarafından erişilebilir durumda olsa bile, değişikliklerin dosya kaynağını içerip içermeyeceği. Bu durum, dosya değişiklik listesinden kaldırıldığında ve bu dosya için başka değişiklik girişi olmayacak olsa bile geçerlidir.
includeDeleted

boolean

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

boolean

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

boolean

Drive'ım hiyerarşisi dışındaki değişikliklerin sonuca dahil edilip edilmeyeceği. Yanlış olarak ayarlandığında, dosyalarda yapılan değişiklikler (ör. Application Data klasöründeki dosyalar veya Drive'ım klasörüne eklenmemiş paylaşılan dosyalar) 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ğini sonraki sayfada devam ettirmek için kullanılan jeton. Bu, ö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. drive, appDataFolder ve photos değerleri desteklenir.
startChangeId
(deprecated)

string (int64 format)

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

boolean

İstek gönderen 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ıtın hangi ek görünüm izinlerini içereceğini belirtir. Yalnızca published desteklenir.
includeLabels

string

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kullanıcı için değişikliklerin listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
Alanlar
items[]

object (Change)

Değişikliklerin listesi. nextPageToken doldurulmuşsa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.
largestChangeId

string (int64 format)

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

string

Değişikliklerin bir sonraki sayfasının sayfa jetonu. Değişiklikler listesinin sonuna ulaşıldıysa bu seçenek görünmez. Jeton herhangi bir nedenle reddedilirse atılmalı 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 olur.
etag

string

Listenin ETag'i.
newStartPageToken

string

Gelecekteki değişiklikler için başlangıç sayfası jetonu. Bu seçenek yalnızca mevcut değişiklik listesinin sonuna ulaşıldığında gösterilir.

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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.