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

Google Drive dosyalarını ve klasörlerini Drive kullanıcı arayüzünü veya Google Drive API'yi kullanarak 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ı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 kazanmak için kaynak anahtarını sağlaması gerekir. Dosyayı yakın zamanda görüntülemiş olan 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ğı nedeniyle dosyaya erişebilen kullanıcılar tarafından bulunabilir. Yalnızca type=domain veya type=anyone izniyle bağlantı üzerinden paylaşılan bu dosyalara erişimi olan kullanıcıların istekleri için kaynak anahtarı gerekebilir.

İzinler hakkında daha fazla bilgi 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 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 hedefinin kaynak anahtarı salt okunur shortcutDetails.targetResourceKey alanında döndürülür.

files kaynağındaki URL'leri döndüren alanlar (ör. exportLinks, webContentLink ve webViewLink) resourceKey öğesini de içerir. Drive kullanıcı arayüzüyle entegre olan istemciler, state parametresinde resourceKeys kullanabilir. Daha fazla bilgi için Dosyaları indirme ve dışa aktarma başlıklı makaleyi inceleyin.

İstek üzerinde kaynak anahtarını ayarlama

Drive API'ye yapılan isteklerde referans verilen 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

Eğik çizgi (/) ayırıcı kullanılarak üstbilgide bir dosya kimliği ve kaynak anahtarı çifti ayarlanır. Başlık, tüm dosya kimliği ve kaynak anahtarı çiftleri virgül (,) ayraçları kullanılarak birleştirilerek 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. Eğik çizgi ve virgül ayırıcılar kullanılarak bu değerlerden oluşturulan başlık şöyledir:

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