Dosya oluşturma ve yönetme

Bu kılavuzda, Google Drive API'yi kullanarak Google Drive'da dosyaların nasıl oluşturulacağı ve yönetileceği açıklanmaktadır.

Dosya oluşturma

Drive'da meta veri veya içerik içermeyen bir dosya oluşturmak için files kaynağında parametre içermeyen create yöntemini kullanın.

Dosyayı oluşturduğunuzda yöntem bir files kaynağı döndürür. Dosyaya kind drive.file, id, name "Başlıksız" ve mimeType application/octet-stream verilir. uploadType gerekli olarak işaretlenir ancak varsayılan olarak media değerini alır. Bu nedenle, aslında sağlamanız gerekmez.

Drive'daki dosya sınırları hakkında daha fazla bilgi için Dosya ve klasör sınırları başlıklı makaleyi inceleyin.

Alanlar parametresini kullanma

Yanıtla döndürülecek alanları belirtmek istiyorsanız fields system parametresini files kaynağının herhangi bir yöntemiyle ayarlayabilirsiniz. fields parametresini atlarsanız sunucu, yönteme özgü varsayılan bir alan kümesi döndürür. Örneğin, list yöntemi her dosya için yalnızca kind, id, name, mimeType ve resourceKey alanlarını döndürür. Farklı alanları döndürmek için Belirli alanları döndürme başlıklı makaleye bakın.

Dosyalarınızla kullanmak için kimlikler oluşturma

generateIds kaynağındaki files yöntemi, Drive'da dosya ve klasör oluştururken veya kopyalarken kullanılabilecek benzersiz dosya kimliklerini önceden oluşturmanıza olanak tanır. Bu, dosya kimliklerini Drive'ın otomatik olarak atamasına izin vermek yerine uygulamanızdan kontrol etmeniz gerektiğinde yararlı olabilir.

count sorgu parametresini kullanarak oluşturulan kimliklerin sayısını ayarlayabilirsiniz. count ayarlanmamışsa varsayılan olarak 10 öğe döndürülür. İsteyebileceğiniz maksimum kimlik sayısı 1.000 ile sınırlıdır.

Ayrıca, kimliklerin kullanılabileceği space ve kimliklerin kullanılabileceği öğelerin type de belirleyebilirsiniz.

Oluşturulan bir kimlik, create veya copy yöntemine id alanı üzerinden aktarılabilir. Böylece, oluşturulan veya kopyalanan dosyanın önceden belirlenmiş kimliği kullandığından emin olabilirsiniz.

Dosya başarıyla oluşturulur veya kopyalanırsa sonraki yeniden denemelerde 409 Conflict HTTP durum kodu yanıtı döndürülür ve yinelenen dosyalar oluşturulmaz.

application/vnd.google-apps.drive-sdk ve application/vnd.google-apps.folder MIME türleri hariç olmak üzere, önceden oluşturulmuş kimliklerin Google Workspace dosyalarının oluşturulmasında desteklenmediğini unutmayın. Benzer şekilde, Google Workspace dosya biçimine dönüştürmeyi referans alan yüklemeler de desteklenmez.

Yalnızca meta verileri içeren dosyalar oluşturma

Yalnızca meta veri içeren dosyalarda içerik bulunmaz. Meta veriler, dosyayı açıklayan verilerdir (ör. name, mimeType ve createdTime). name gibi alanlar kullanıcıdan bağımsızdır ve her kullanıcı için aynı şekilde görünür. viewedByMeTime gibi alanlar ise kullanıcıya özel değerler içerir.

Yalnızca meta veri içeren dosyalara örnek olarak MIME türü application/vnd.google-apps.folder olan bir klasör verilebilir. Daha fazla bilgi için Klasör oluşturma ve klasörlere içerik ekleme başlıklı makaleyi inceleyin. Başka bir örnek, MIME türü application/vnd.google-apps.shortcut olan Drive'daki başka bir dosyayı işaret eden bir kısayoldur. Daha fazla bilgi için Drive dosyasının kısayolunu oluşturma başlıklı makaleyi inceleyin.

Küçük resimleri yönetme

Küçük resimler, kullanıcıların Drive dosyalarını tanımlamasına yardımcı olur. Drive, yaygın dosya türleri için otomatik olarak küçük resimler oluşturabilir veya uygulamanız tarafından oluşturulan bir küçük resim sağlayabilirsiniz. Daha fazla bilgi için Küçük resim yükleme başlıklı makaleyi inceleyin.

Mevcut bir dosyayı kopyalama

Bir dosyayı kopyalamak ve istenen güncellemeleri uygulamak için files kaynağında copy yöntemini kullanın. Kopyalanacak fileId öğesini bulmak için list yöntemini kullanın.

Güncellemeleri yama semantiği aracılığıyla uygulayabilirsiniz. Bu sayede, bir kaynakta kısmi değişiklikler yapabilirsiniz. İsteğinizde değiştirmek istediğiniz alanları açıkça ayarlamanız gerekir. İsteğe dahil edilmeyen alanlar mevcut değerlerini korur. Daha fazla bilgi için Kısmi kaynaklarla çalışma başlıklı makaleyi inceleyin.

Kopyalanan dosyanın dosya kimliğini generateIds yöntemini kullanarak önceden ayarlayabilirsiniz. Daha fazla bilgi için Dosyalarınızla kullanmak üzere kimlik oluşturma başlıklı makaleyi inceleyin.

Çağrıyı yetkilendirmek için uygun bir Drive API kapsamı kullanmanız gerektiğini unutmayın. Drive kapsamları hakkında daha fazla bilgi için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.

Sınırlar ve dikkat edilmesi gereken noktalar

Dosyaları kopyalamaya hazırlanırken aşağıdaki sınırlamaları ve hususları göz önünde bulundurun:

  • İzinler:

  • Dosya yönetimi:

    • Üçüncü taraf kısayolları gibi bazı dosyalar hiçbir zaman kopyalanamaz.
    • Bir dosyayı yalnızca bir üst klasöre kopyalayabilirsiniz. Birden fazla üst öğe belirtmek desteklenmez. parents alanı belirtilmezse dosya, kaynak dosyadan bulunabilir üst öğeleri devralır.
    • Klasörler bir dosya türü olsa da kopyalanamaz. Bunun yerine bir hedef klasör oluşturun ve mevcut dosyaların parents alanını hedef klasör olarak ayarlayın. Ardından orijinal kaynak klasörü silebilirsiniz.
    • Yeni bir dosya adı belirtilmediği sürece copy yöntemi, orijinal dosyayla aynı ada sahip bir dosya oluşturur.
    • copy öğesinin aşırı kullanımı, Drive API kota sınırlarınızın aşılmasına neden olabilir. Daha fazla bilgi için Kullanım sınırları başlıklı makaleyi inceleyin.

Deneyebileceğiniz bazı sonraki adımlar: