Bagaimana untuk mengalih keluar metadata dalam Google Drive

Adakah anda mahu mengawal metadata fail anda dalam Pemacu Google dan tak tahu nak mula dari mana? Di sini kami menerangkan secara terperinci, Cara mengalih keluar metadata dalam Google Drive dengan berkesan dan selamat (metadata fail yang dimuat naik). Kami juga memberitahu anda had yang dikenakan oleh Google pada nama fail, saiz dan kebenaran.

Panduan ini akan memberi anda pemahaman yang lengkap dan realistik tentang perkara yang boleh (dan tidak boleh) "dipadamkan" apabila melibatkan metadata dalam Google Drive.

Perkara yang boleh ditukar atau "dipadamkan" dalam Drive

Ini adalah metadata yang boleh dialih keluar daripada fail yang dimuat naik ke Google Drive:

Nombre y extensión: Apabila membuat fail melalui API, adalah idea yang baik untuk menentukan sambungan dalam medan nama, contohnya, "cat.jpg." Drive boleh membuat kesimpulan sambungan daripada jenis MIME jika anda tidak menyatakannya, tetapi lebih baik untuk menentukannya sendiri. Dalam respons seterusnya, sambungan fail baca sahaja mungkin muncul dengan sambungan yang diisikan daripada nama. Jika pengguna memuat turun fail, Drive menyusun nama akhir daripada tajuk (dan sambungannya).

• Teks boleh indeks (contentHints.indexableText): Drive mengindeks dokumen dan jenis biasa (PDF, imej berdaya OCR, dll.) secara lalai. Jika apl anda menyimpan format lain (lukisan, video, pintasan), anda boleh menyediakan teks boleh diindeks untuk menambah baik carian. Teks ini diproses sebagai HTML: jika anda menghantar rentetan yang mengandungi teg, kandungan teks diindeks, bukan atribut teg. Terdapat had saiz 128KB untuk contentHints.indexableText, dan anda disyorkan untuk mengemas kininya pada setiap simpan dan memastikannya relevan dengan fail.
• Imej kecil (contentHints.thumbnail): Drive menjana lakaran kenit untuk pelbagai jenis, tetapi untuk format yang tidak menjananya secara automatik, anda boleh memuat naik imej anda sendiri apabila anda membuat atau mengemas kini fail. Anda mesti menetapkan imej kepada base64 selamat URL dan mimeType yang sepadan. Peraturan utama: Format yang disokong ialah PNG, GIF atau JPG; lebar yang disyorkan ialah 1600px (minimum 220px) dan saiz maksimum ialah 2MB. Imej kecil tidak sah apabila kandungan fail berubah; perubahan metadata tidak.
• Akses kepada lakaran kecil: Medan ThumbnailLink mengembalikan URL pendek, hanya boleh diakses jika apl mempunyai kebenaran untuk membaca fail (jika ia tidak umum, anda perlu memintanya dengan bukti kelayakan). Anda boleh menanyakannya untuk fail tertentu atau untuk senarai yang ditapis mengikut jenis.
• Label: Drive membolehkan anda mengaitkan label dengan fail. Untuk mencarinya, anda boleh menggunakan files.listLabels dan untuk mengubah suainya, anda mesti merujuk labelId dan fileId yang sepadan. Mekanisme ini berguna untuk mengkategorikan dan, jika perlu, "membersihkan" klasifikasi yang tidak diingini tanpa menyentuh kandungan.

Padamkan metadata dalam Google Drive: metadata "tersembunyi" daripada fail itu sendiri

Tiada butang ajaib untuk mengalih keluar metadata dalam Google Drive (seperti EXIF ​​​​dalam foto atau data terbenam dalam PDF). Drive mengurus metadatanya sendiri, tetapi metadata dalam fail bergantung pada alat yang menciptanya.

Amalan yang disyorkan ialah bersihkan fail sebelum memuat naiknya ke Drive, Menggunakan alat sistem atau apl khusus yang mengalih keluar data EXIF ​​​​dari imej atau sifat dokumen. Dengan cara ini, kandungan yang anda simpan dalam Drive akan "disesihkan".

Jika anda sudah mempunyai fail yang dimuat naik dengan metadata terbenam, bukannya mengalih keluar metadata dalam Google Drive, ia lebih mudah muat turun, bersihkan dan muat naik semula, menggantikan yang asal jika berkenaan. Dengan PDF atau imej, ini adalah perkara biasa apabila anda ingin melindungi kepengarangan, lokasi atau sejarah penyuntingan.

Untuk bahagian tertentu Drive, fokus pada melaraskan nama, label dan Petua kandungan (Teks boleh diindeks/lakaran kecil), yang berada di bawah kawalan anda. Jika anda turut mengurus kebenaran akses, anda turut mengurangkan pendedahan metadata yang boleh dilihat (contohnya, pautan lakaran kecil yang boleh diakses oleh mereka yang mempunyai hak membaca).

Jangan lupa itu Menukar metadata Drive sahaja tidak mengalih keluar EXIF ​​​​atau sifat dalaman. Oleh itu, strategi anda harus menggabungkan prapembersihan fail dengan pengurusan metadata terperinci yang membolehkan anda sentuh oleh Drive.

Metadata yang biasa dikelirukan dalam Google Cloud: VM, gcloud dan had

Jika anda bekerja dengan Google Cloud, anda akan melihat banyak panduan tentang "metadata" yang sebenarnya merujuk kepada Compute Engine atau Cloud Storage, bukan Drive. Walaupun begitu, anda perlu mengetahui perkara-perkara ini supaya anda tidak mencampurkannya semasa membuat penyelidikan.

Konfigurasi asas gcloud CLI

Selepas memasang Google Cloud CLI, mulakan dengan:

gcloud init

Adalah penting untuk memastikan anda mempunyai versi terkini dengan:

gcloud components update

Jika anda menggunakan pembekal identiti luaran, Log masuk dengan identiti persekutuan anda sebelum bekerja dengan gcloud, terutamanya jika anda akan membuat pengesahan untuk membuat panggilan REST dari persekitaran setempat anda. Sampel REST API boleh menggunakan bukti kelayakan yang telah anda konfigurasikan dalam gcloud.

VMs

Kebenaran dan peranan (Enjin Pengiraan): Untuk menambah, mengemas kini atau memadamkan metadata tersuai pada VM, anda memerlukan kebenaran IAM yang sesuai. Contoh biasa termasuk:

• Jika VM anda menggunakan akaun perkhidmatan: kebenaran iam.serviceAccounts.actAs dalam akaun perkhidmatan atau projek.
• Metadatos del proyecto: compute.projects.get y compute.projects.setCommonInstanceMetadata.
• Metadata zon: compute.instanceSettings.get y compute.instanceSettings.update untuk kawasan berkenaan.
• Metadata contoh: compute.instances.get y compute.instances.setMetadata.

Limitaciones

Ini ialah had utama yang kami temui semasa cuba mengalih keluar metadata dalam Google Drive:

• Had Saiz (Enjin Kira): Jumlah gabungan entri metadata dihadkan pada 512 KB. Setiap kunci dihadkan kepada 128 bait, dan setiap nilai dihadkan kepada 256 KB. Jika, sebagai contoh, anda menggunakan kekunci ssh-keys dan melebihi had 256 KB, anda tidak akan dapat menambah lebih banyak kunci sehingga anda membersihkannya.
• Mayúsculas y minúsculas: Kunci adalah sensitif huruf besar-besaran; nilai juga, kecuali Booleans. Dalam zon, anda tidak boleh mencipta dua kekunci yang berbeza hanya dalam kes (zonal-metadata-key lwn. ZONAL-METADATA-KEY).
• Metadata zon: ditetapkan atau dialih keluar menggunakan gcloud atau REST. Anda tidak boleh menentukan nilai zon untuk kunci SSH (ssh-keys). Dalam projek/direktori logik, jika terdapat nilai peringkat projek dan zon untuk kunci yang sama, nilai zon diutamakan dalam zonnya.
• Nilai boolean yang disokong: Selain BENAR/SALAH, anda boleh menggunakan Y/Ya/1 dan N/Tidak/0 (tidak sensitif huruf besar-besaran).
• Skop Konfigurasi (Enjin Kira):
  • Proyecto: metadata biasa kepada semua VM dalam projek.
  • Zonal: entri yang menjejaskan semua VM dalam zon tertentu dan boleh mengatasi nilai projek.
  • Instancia: metadata untuk VM tertentu (sedang dibuat atau sudah sedia ada).

Imej kecil, pengindeksan dan pengambilan metadata dalam Drive (REST dan amalan terbaik)

Sekarang mari kita lihat peranan lakaran kecil semasa mengalih keluar metadata dalam Google Drive. Dan juga cara terbaik untuk memulihkannya:

• Pengesahan untuk REST di premis: Jika anda sedang menguji contoh REST daripada mesin anda, gunakan bukti kelayakan yang dikonfigurasikan dengan gcloud. Dengan cara ini, panggilan API Drive anda akan menghormati identiti dan kebenaran yang telah anda tetapkan.
• Muat naik lakaran kecil tersuai: tetapkan contentHints.thumbnail dengan dua medan: imej base64 yang selamat URL dan mimeType yang betul. Jika Drive boleh menjana lakaran kecil secara automatik, ia akan menggunakan lakaran kecil itu sendiri dan melangkau lakaran kecil anda. Jika tidak, ia akan menggunakan yang anda sediakan.

Peraturan utama untuk lakaran kecil dalam Drive:

• Format: PNG, GIF atau JPG.
• Lebar yang disyorkan: 1600 px (minimum 220 px).
• Tamaño máximo: 2 MB.
• Kemas kini lakaran kecil dengan setiap simpan jika ia masih berkaitan.

Penting tentang pembatalan: Imej kecil tidak sah apabila kandungan fail diubah; perubahan metadata tidak. Jika anda hanya menukar teg atau nama, jangan mengharapkan lakaran kecil baharu melainkan anda mengubah suai fail.

Teks boleh diindeks

Jangan cuba "menipu" carian dengan kata kunci. Tangkap konsep dan istilah yang pengguna akan cari dengan munasabah untuk fail itu, dan semak had 128KB. Kemas kini apabila kandungan berubah dengan ketara.

Gunakan nama dan sambungan yang konsistenApabila boleh, masukkan sambungan dalam nama semasa memuat naik; jika ia tiada, Drive akan cuba menyimpulkannya dengan MIME. Menjaga nama tetap jelas akan mengelakkan kekaburan dan membolehkan carian sambungan lebih mudah.

Teg dalam Drive

Untuk mengubah suai label, perhatikan pengecam yang diperlukan. Anda memerlukan labelId label dan fileId fail. Anda boleh menyenaraikannya dahulu dengan files.listLabels dan kemudian gunakan perubahan yang sepadan pada fail sasaran.

// Al modificar etiquetas de un archivo en Drive:
// - labelId: identificador de la etiqueta a cambiar
// - fileId: identificador del archivo al que aplicas la etiqueta
// Usa files.listLabels para localizarlas antes de actualizar.

Ingatlah bahawa, Walaupun Drive menjadi tumpuan, banyak perkembangan menggabungkan Drive dengan Cloud Storage atau perkhidmatan lain, Oleh itu anda akan melihat contoh Storan untuk memeriksa atribut objek.

// Ejemplo en Go para obtener atributos de un objeto en Cloud Storage (no Drive)
// e imprimir metadatos como ContentType, CacheControl, MD5, etc.
// Útil si tu flujo sube primero a Storage y luego a Drive.
import (
  "context"
  "fmt"
  "io"
  "time"
  "cloud.google.com/go/storage"
)

func getMetadata(w io.Writer, bucket, object string) (*storage.ObjectAttrs, error) {
  ctx := context.Background()
  client, err := storage.NewClient(ctx)
  if err != nil { return nil, fmt.Errorf("storage.NewClient: %w", err) }
  defer client.Close()

  ctx, cancel := context.WithTimeout(ctx, 10*time.Second)
  defer cancel()

  o := client.Bucket(bucket).Object(object)
  attrs, err := o.Attrs(ctx)
  if err != nil { return nil, fmt.Errorf("Object(%q).Attrs: %w", object, err) }

  fmt.Fprintf(w, "Bucket: %v\n", attrs.Bucket)
  fmt.Fprintf(w, "CacheControl: %v\n", attrs.CacheControl)
  fmt.Fprintf(w, "ContentDisposition: %v\n", attrs.ContentDisposition)
  fmt.Fprintf(w, "ContentEncoding: %v\n", attrs.ContentEncoding)
  fmt.Fprintf(w, "ContentLanguage: %v\n", attrs.ContentLanguage)
  fmt.Fprintf(w, "ContentType: %v\n", attrs.ContentType)
  fmt.Fprintf(w, "Crc32c: %v\n", attrs.CRC32C)
  fmt.Fprintf(w, "Generation: %v\n", attrs.Generation)
  fmt.Fprintf(w, "KmsKeyName: %v\n", attrs.KMSKeyName)
  fmt.Fprintf(w, "Md5Hash: %v\n", attrs.MD5)
  fmt.Fprintf(w, "MediaLink: %v\n", attrs.MediaLink)
  fmt.Fprintf(w, "Metageneration: %v\n", attrs.Metageneration)
  fmt.Fprintf(w, "Name: %v\n", attrs.Name)
  fmt.Fprintf(w, "Size: %v\n", attrs.Size)
  fmt.Fprintf(w, "StorageClass: %v\n", attrs.StorageClass)
  fmt.Fprintf(w, "TimeCreated: %v\n", attrs.Created)
  fmt.Fprintf(w, "Updated: %v\n", attrs.Updated)
  fmt.Fprintf(w, "Event-based hold enabled? %t\n", attrs.EventBasedHold)
  fmt.Fprintf(w, "Temporary hold enabled? %t\n", attrs.TemporaryHold)
  fmt.Fprintf(w, "Retention expiration time %v\n", attrs.RetentionExpirationTime)
  fmt.Fprintf(w, "Custom time %v\n", attrs.CustomTime)
  fmt.Fprintf(w, "Retention: %+v\n", attrs.Retention)
  fmt.Fprintf(w, "\n\nMetadata\n")
  for key, value := range attrs.Metadata {
    fmt.Fprintf(w, "\t%v = %v\n", key, value)
  }
  return attrs, nil
}

Memadamkan fail berbanding pemadaman metadata dalam Google Drive

Si lo que quieres es padamkan fail daripada DriveSebagai pemilik, anda boleh mengalihkannya ke sampah dari web dengan mengklik kanan dan memilih Alih ke Sampah. Jika pemiliknya adalah orang lain, anda hanya boleh "Alih keluar" fail daripada pandangan anda; orang lain masih akan dapat melihatnya.

Untuk Untuk memadamkan fail secara kekal, anda mesti mengosongkan sampah atau menggunakan pilihan pemadaman kekal, Dalam kes ini, anda tidak akan dapat memulihkannya. Ini, dengan sendirinya, tidak "mengalih keluar metadata" daripada fail lain—ia hanya digunakan pada item itu.

Anda tidak boleh memadamkan metadata dalam Google Drive daripada fail bukan milik anda, kerana kawalan mereka adalah milik orang yang menciptanya atau seseorang yang mempunyai kebenaran yang lebih tinggi dalam organisasi. Dalam kes ini, anda hanya mengalih keluar akses atau keterlihatan anda.

Mengaitkannya dengan metadata: Memadamkan fail akan memadamkan metadatanya dalam Drive bersama-sama dengannya, tetapi ia tidak menjejaskan metadata dalam salinan lain atau metadata terbenam dalam dokumen lain yang kekal dalam sistem.

Dengan semua perkara di atas, anda kini boleh membezakan dengan baik Metadata yang dikawal oleh Drive (nama, teg, petunjuk carian dan lakaran kenit), cara menyoalnya melalui REST, amalan terbaik yang perlu diikuti untuk membersihkan data terbenam sebelum memuat naik, dan had serta kebenaran yang akan dimainkan apabila anda menjumpai dokumentasi Google Cloud yang bercakap tentang "metadata" dalam konteks lain.