Method: changes.list

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

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.

includeItemsFromAllDrives

boolean

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

includeRemoved

boolean

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

includeTeamDriveItems
(deprecated)

boolean

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

pageSize

integer

Sayfa başına 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.

restrictToMyDrive

boolean

Sonuçların, Drive'ım hiyerarşisindeki değişikliklerle kısıtlanıp kısıtlanmayacağı. Bu seçenek, Uygulama Verileri klasöründekiler veya Drive'ım bölümüne eklenmemiş paylaşılan dosyalar gibi dosyalarda yapılan değişiklikler hariç tutulur.

spaces

string

Şirket içinde sorgulanacak alanların virgülle ayrılmış listesi. "drive" ve "appDataKlasör" değerleri desteklenir.

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 "yayınlandı" değeri 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
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
Alanlar
kind

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit dize "drive#changeList".

nextPageToken

string

Sonraki değişiklik sayfasının sayfa jetonu. Değişiklik listesinin sonuna ulaşıldıysa bu öğe bulunmaz. Sayfa jetonunun süresi dolmaz.

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. Sayfa jetonunun süresi dolmaz.

changes[]

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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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.