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ın yetkisiz erişime karşı korunmasına yardımcı olur. Kaynak anahtarları, kullanıcıların 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 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ğı nedeniyle 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 için Dosya, klasör ve Drive'ları paylaşma başlıklı makaleyi inceleyin. Rollerin ve her birinin izin verdiği işlemlerin tam listesi için Roller ve izinler başlıklı makaleye bakın.

Dosyadaki kaynak anahtarını 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ğındaki URL döndüren alanlar (ör. exportLinks, webContentLink ve webViewLink) resourceKey'yi 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 gönderilen isteklerde referans verilen 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