Bir kullanıcı veya ortak Drive ile ilgili değişiklikleri listeler. Daha fazla bilgi için Değişiklikleri alma bölümüne bakın.
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. 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 |
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. |
includeItemsFromAllDrives |
Hem Drive'ım hem de ortak Drive'daki öğelerin sonuçlara dahil edilip edilmeyeceğini belirtir. |
includeRemoved |
Öğelerin, silme veya erişim kaybı gibi nedenlerle değişiklik listesinden kaldırıldığını belirten değişikliklerin dahil edilip edilmeyeceği. |
includeTeamDriveItems |
Desteği sonlandırıldı: Bunun yerine |
pageSize |
Sayfa başına döndürülecek maksimum değişiklik sayısı. |
pageToken |
Ö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. |
restrictToMyDrive |
Sonuçların Drive'ım hiyerarşisindeki değişikliklerle kısıtlanıp kısıtlanmayacağını belirtir. Bu işlem, Uygulama Verileri klasöründeki veya Drive'ıma eklenmemiş paylaşılan dosyalar gibi dosyalarda yapılan değişiklikleri atlar. |
spaces |
Varlık kümelerinde sorgulanacak alanların virgülle ayrılmış listesi. Desteklenen değerler "drive" ve "appDataFolder"dır. |
supportsAllDrives |
İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği. |
supportsTeamDrives |
Desteği sonlandırıldı: Bunun yerine |
teamDriveId |
Desteği sonlandı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
Bir kullanıcıya ait 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 |
Bu kaynağın ne tür olduğunu tanımlar. Değer: |
nextPageToken |
Değişikliklerin bir sonraki sayfası için sayfa jetonu. Değişiklikler listesinin sonuna ulaşıldıysa bu seçenek gösterilmez. 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 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/drive
https://www.googleapis.com/auth/drive.appdata
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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.