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

Drive kullanıcı arayüzünü kullanarak veya Google Drive API üzerinden Google Drive dosya ve klasörlerini başkalarıyla paylaşabilirsiniz. Drive'dan paylaşımda bulunduğunuzda, dosyayı düzenleme, dosyada yorum yapma ya da yalnızca dosyayı açma seçenekleriyle, paylaşımda bulunduğunuz kullanıcıların erişimlerini yönetebilirsiniz.

Kaynak anahtarı, dosyanızı istenmeyen erişime karşı korumaya yardımcı olur. Kaynak anahtarları, kullanıcıların bir bağlantı kullanılarak 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 kazanmak için kaynak anahtarını sağlaması gerekir. Dosyayı yakın zamanda görüntülemiş veya doğrudan erişim sahibi 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ğının sonucu olarak 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şimi olan kullanıcılardan gelen istekler kaynak anahtarı gerektirebilir.

İzinler hakkında daha fazla bilgi edinmek için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin. Rollerin ve her birinin izin verdiği işlemlerin tam listesi için Roller ve izinler bölümüne bakın.

Dosyadan kaynak anahtarını oku

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

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

files kaynağında bulunan ve URL döndüren exportLinks, webContentLink ve webViewLink gibi alanlar da resourceKey içerir. Drive kullanıcı arayüzüyle entegre olan istemciler, state parametresinde resourceKeys özelliğini de kullanabilir. Daha fazla bilgi için Dosyaları indirme ve dışa aktarma bölümünü inceleyin.

İstekteki kaynak anahtarını ayarlayın

Drive API'ye yapılan istekler tarafından başvurulan 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 üst bilgisiyle bir veya daha fazla kaynak anahtarı belirtebilir.

Söz dizimi

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

Örneğin, fileId1 dosyasını fileId2 klasöründen fileId3 klasörüne taşıma isteğini ele alalım. Bu üç dosyanın kaynak anahtarlarının sırasıyla resourceKey1, resourceKey2 ve resourceKey3 olduğunu varsayalım. Öne 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