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

Google Drive dosya ve klasörlerini Drive kullanıcı arayüzünü veya Google Drive API'yi kullanarak başkalarıyla paylaşabilirsiniz. Drive'dan dosya paylaştığınızda, kullanıcıların düzenleme, yorum yapma ya da yalnızca dosyayı açma erişimi olmasını seçebilirsiniz.

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 dosyaya 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. Yalnızca type=domain veya type=anyone izniyle bu bağlantıyla paylaşılan dosyalara erişebilen kullanıcıların istekleri için kaynak anahtarı gerekebilir.

İzinler hakkında daha fazla bilgi edinmek için Dosya, klasör ve sürücüleri paylaşma başlıklı makaleye göz atın. Rollerin ve her birinin izin verdiği işlemlerin tam listesi için Roller ve izinler başlıklı makaleye 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ısayolu ise kısayol hedefine ait 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 entegre olan istemciler, state parametresinde resourceKeys değerini de kullanabilir. Daha fazla bilgi için Dosya indirme ve dışa aktarma başlıklı makaleyi inceleyin.

İstekte kaynak anahtarını ayarlama

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 üst bilgisiyle bir veya daha fazla kaynak anahtarı belirtebilir.

Söz dizimi

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

Örneğin, fileId1 dosyasını fileId2 klasöründen fileId3 klasörüne taşıma isteğini düşünün. Bu üç dosyanın 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:

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