Bağlantıyla paylaşılan Drive dosyalarına kaynak anahtarlarını kullanarak erişme

Drive kullanıcı arayüzünü veya Google Drive API'yi kullanarak Google Drive dosya ve klasörlerini başkalarıyla paylaşabilirsiniz. Drive'dan paylaşımda bulunduğunuzda, kullanıcıların dosyayı düzenleme, dosyada yorum yapma ya da yalnızca dosyayı açma işlemlerini yapıp yapamayacağını kontrol edebilirsiniz.

Kaynak anahtarı, dosyanızı istenmeyen erişime karşı korumaya yardımcı olur. Kaynak anahtarları, kullanıcıların bir bağlantı aracılığıyla paylaşılan belirli dosyalara erişebilmesi için iletilen ek bir parametredir. Dosyayı daha önce görüntülememiş olan kullanıcıların erişim elde etmek için kaynak anahtarını sağlaması gerekir. Dosyayı yakın zamanda görüntülemiş veya doğrudan erişimi olan kullanıcıların dosyaya erişmek için kaynak anahtarına ihtiyacı yoktur.

Bağlantıyla paylaşılan bir Drive dosyası, yalnızca type=user veya type=group permissions kaynağı sonucunda dosyaya erişebilen kullanıcılar tarafından bulunabilir. Bağlantıyla paylaşılan bu dosyalara yalnızca type=domain veya type=anyone izni kullanarak erişebilen kullanıcılardan gelen istekler için kaynak anahtarı gerekebilir.

İzinler hakkında daha fazla bilgi edinmek için Dosya, klasör ve drive'ı paylaşma başlıklı makaleye göz atın. Rollerin ve her biri tarafından izin verilen işlemlerin tam listesi için Roller ve izinler bölümüne bakın.

Kaynak anahtarını dosyadan okuma

Drive API, files kaynağının salt okunur resourceKey alanında bir dosyanın kaynak anahtarını döndürür.

Dosya bir Drive kısayoluysa kısayol hedefinin kaynak anahtarı salt okunur shortcutDetails.targetResourceKey alanında döndürülür.

files kaynağında, URL'leri döndüren alanlar (ör. exportLinks, webContentLink ve webViewLink) resourceKey ifadesini de içerir. Drive kullanıcı arayüzüyle entegrasyon yapan istemciler, state parametresinde resourceKeys iznini de kullanabilir. Daha fazla bilgi için Dosyaları indirme ve dışa aktarma bölümüne bakın.

İstekte kaynak anahtarını ayarlayın

Drive API'ye yapılan isteklerin referans verdiği tüm dosyaların kaynak anahtarları, X-Goog-Drive-Resource-Keys HTTP başlığında ayarlanır.

Drive API'ye yapılan istekler, X-Goog-Drive-Resource-Keys HTTP başlığıyla bir veya daha fazla kaynak anahtarı belirtebilir.

Söz dizimi

Dosya kimliği ve kaynak anahtar çifti, düz eğik çizgi (/) ayırıcı kullanılarak başlıkta ayarlanır. Başlık, virgül (,) ayırıcıları kullanılarak tüm dosya kimliği ve kaynak anahtarı çiftleri birleştirilerek oluşturulur.

Örneğin, fileId1 dosyasının fileId2 klasöründen fileId3 klasörüne taşınması için istek gönderebilirsiniz. Bu üç dosya için kaynak anahtarlarının sırasıyla resourceKey1, resourceKey2 ve resourceKey3 olduğunu varsayalım. Eğik çizgi ve virgül ayırıcıları kullanılarak bu değerlerden oluşturulan başlık şu şekildedir:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3