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 |
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. |
includeDeleted |
Öğelerin değişiklik listesinden kaldırıldığını belirten değişikliklerin (ör. silme veya erişim kaybı) eklenip eklenmeyeceğini belirtir. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive öğelerinin sonuçlara dahil edilip edilmeyeceği. |
includeSubscribed |
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 |
Kullanımdan kaldırıldı: Bunun yerine |
maxResults |
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 |
spaces |
Sorgulanacak alanların virgülle ayrılmış listesi. |
startChangeId |
Kullanımdan kaldırıldı: Bunun yerine |
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 |
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 |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Alanlar | |
---|---|
largestChangeId |
Mevcut en büyük değişiklik kimliği. |
nextPageToken |
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 |
Bu her zaman |
etag |
Listenin ETag. |
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. |
selfLink |
Bu listeye geri dönme bağlantısı. |
nextLink |
Sonraki değişiklikler sayfasının bağlantısı. |
items[] |
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.