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 |
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 |
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 |
Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği. |
includeRemoved |
Öğelerin değişiklik listesinden kaldırıldığını belirten değişikliklerin (ör. silme veya erişim kaybı) eklenip eklenmeyeceğini belirtir. |
includeTeamDriveItems |
Kullanımdan kaldırıldı: Bunun yerine |
pageSize |
Sayfa başına döndürülecek maksimum değişiklik sayısı. |
pageToken |
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 |
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 |
Şirket içinde sorgulanacak alanların virgülle ayrılmış listesi. "drive" ve "appDataKlasör" değerleri desteklenir. |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'larım hem de ortak Drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Kullanımdan kaldırıldı: Bunun yerine |
teamDriveId |
Kullanımdan kaldırıldı: Bunun yerine |
includePermissionsForView |
Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" değeri desteklenir. |
includeLabels |
Yanıtın |
İ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 ( |
Alanlar | |
---|---|
kind |
Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit dize |
nextPageToken |
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 |
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[] |
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.