Faʻafefea ona aveese metadata ile Google Drive

Faʻafouina mulimuli: 18/08/2025

  • Malamalama po'o le a le metadata Drive e pulea (igoa, pine, indexableText, ma thumbnails) ma po'o le a le metadata e iai i isi Google Cloud services.
  • Fa'aoga le Drive API e su'e ma fetu'una'i metadata; mama EXIF ​​​​ma faʻapipiʻi faʻamaumauga aʻo leʻi tuʻuina atu faila.
  • Fa'aaloalo i tapula'a ma tulafono (aitioti, fa'asino upu, fa'aopoopoga) ma fa'amaoni i le gcloud mo su'ega REST i le lotoifale.
tape metadata ile Google Drive

E te manaʻo e pulea metadata o au faila i totonu Drive Google ma e te le iloa po o fea e amata ai? O iinei matou te faʻamatalaina auiliili, Fa'afefea ona aveese metadata ile Google Drive lelei ma saogalemu (le metadata o faila na lafoina). Matou te taʻu atu foʻi ia te oe le tapulaʻa e tuʻuina atu e Google i igoa faila, lapopoa, ma faʻatagaga.

O lenei taʻiala o le a tuʻuina atu ia te oe le malamalama atoatoa ma le moni o mea e mafai (ma e le mafai) ona "tapēina" pe a oʻo mai i metadata ile Google Drive.

O le a le mea e mafai ona suia pe "tapē" ile Drive

O nei mea metadata e mafai ona aveese mai faila na lafoina i Google Drive:

Igoa ma le faʻaopoopoga: Pe a fatuina se faila e ala i le API, o se manatu lelei le faʻamaonia o le faʻaopoopoga i le igoa fanua, mo se faʻataʻitaʻiga, "cat.jpg." E mafai e le ta'avale ona fa'ailoa le fa'aopoopoga mai le ituaiga MIME pe a e le fa'ama'oti mai, ae sili atu le fa'auiga e oe. I tali mulimuli ane, e mafai ona aliali mai se faila na'o le faitau fa'aopoopo ma le fa'aopoopoga o lo'o fa'aigoaina mai le igoa. Afai e la'uina e se tagata fa'aoga le faila, e tu'ufa'atasia e Drive le igoa fa'ai'u mai le ulutala (ma lona fa'aopoopoga).

  • Fa'asinomaga fa'asino (contentHints.indexableText): Ave fa'asino igoa pepa masani ma ituaiga (PDFs, OCR-mafai ata, ma isi) ona o le faaletonu. Afai e fa'asaoina e lau app isi fa'atulagaga (ata, ata, ata pupuu), e mafai ona e tu'uina atu tusitusiga fa'asino e fa'aleleia atili ai su'esu'ega. O lenei tusitusiga o lo'o fa'aogaina e pei o le HTML: afai e te pasia se manoa o lo'o i ai fa'ailoga, o le anotusi o lo'o fa'asinoina, ae le o uiga fa'ailoga. E 128KB le lapo'a fa'atapula'a mo contentHints.indexableText, ma e fautuaina e te fa'afou i luga o fa'amaumauga ta'itasi ma fa'atumauina talafeagai i le faila.
  • Laiti (contentHints.thumbnail): E fa'atupuina e le ta'avale ata mo le tele o ituaiga, ae mo fa'asologa e le otometi ona fa'atupuina, e mafai ona e fa'ae'e lau oe lava pe a e fa'afou pe fa'afou le faila. E tatau ona e setiina le ata ile URL-safe base64 ma le mimeType talafeagai. Tulafono Autu: O fa'atulagaga lagolago o PNG, GIF, po'o JPG; fautuaina le lautele o le 1600px (la'ititi 220px), ma le maualuga maualuga o le 2MB. E fa'aleaogaina ata pu'upu'u pe a suia le anotusi o le faila; suiga metadata e leai.
  • Avanoa i ata laiti: O le ThumbnailLink field e toe fa'afo'i mai ai se URL pu'upu'u, e na'o le fa'atagaina o le app e faitau ai le faila (afai e le fa'alaua'itele, e mana'omia lou talosagaina ma fa'amaonia). E mafai ona e su'eina mo se faila patino po'o se lisi ua fa'amama i le ituaiga.
  • Fa'ailoga: Aveta'avale fa'atagaina oe e fa'afeso'ota'i fa'ailoga ma faila. Ina ia maua i latou, e mafai ona e fa'aogaina files.listLabels, ma e sui ai, e tatau ona e fa'asino i le igoaId ma le failaId. O lenei masini e aoga mo le faʻavasegaina ma, pe a manaʻomia, "faʻamamaina" faʻavasegaga e le manaʻomia e aunoa ma le paʻi i mea.
Mea fa'apitoa - Kiliki i'i  Gemini 2.5 Pro ua saoloto nei: O le auala lea e galue ai le ata sili ona atoatoa a Google.
tape metadata ile Google Drive
Ave'ese metadata ile Google Drive

Aveese metadata ile Google Drive: "natia" metadata mai le faila lava ia

E leai se faʻamau faʻailoga e aveese metadata i Google Drive (pei o EXIF ​​​​i ata poʻo faʻamaumauga faʻapipiʻi i PDFs). O le ta'avale e pulea ana lava metadata, ae o le metadata i totonu o le faila e fa'alagolago i le meafaigaluega na faia ai.

Ole fa'ata'ita'iga fautuaina ole fa'amama le faila a'o le'i tu'uina i le Drive, Faʻaaogaina meafaigaluega faʻapitoa poʻo faʻapitoa faʻapitoa e aveese faʻamatalaga EXIF ​​​​mai ata poʻo meatotino pepa. O le auala lea, o mea e te fa'asaoina i le Drive e o'o mai "fa'amama."

Afai ua uma ona faʻapipiʻi faila ma metadata faʻapipiʻi, nai lo le aveese metadata ile Google Drive, e sili atu ona faigofie. la'u mai, fa'amama ma toe tu'u i luga, sui le uluai tusi pe a talafeagai. Faatasi ai ma PDFs poʻo ata, e masani lava pe a e manaʻo e puipuia le tusitala, nofoaga, poʻo le faʻasologa o talaʻaga.

Mo le vaega patino o le Drive, taula'i i le fetu'una'iga o igoa, fa'ailoga ma mea fa'ailoa (indexableText/thumbnail), o lo'o i lalo o lau pule. Afai e te pulea fo'i fa'atagaga avanoa, e te fa'aitiitia fo'i le fa'aalia o metadata va'aia (mo se fa'ata'ita'iga, o feso'ota'iga ata e mafai ona maua e i latou o lo'o i ai aia tatau faitau).

Aua neʻi galo lena Suiga na'o le Drive metadata e le aveesea ai EXIF ​​​​po'o mea i totonu. O le mea lea, o lau fuafuaga e tatau ona tuʻufaʻatasia aʻo leʻi faʻamamāina le faila ma le faʻaogaina o metadata faʻataʻitaʻiga e mafai e le Drive ona e tago i ai.

Metadata masani fenumiai i Google Cloud: VMs, gcloud, ma tapulaʻa

Afai e te galue ma Google Cloud, o le a e vaʻaia le tele taiala e uiga i "metadata" e faasino tonu i le Compute Engine poʻo le Cloud Storage, ae le o le Drive. Ae ui i lea, e te manaʻo e iloa nei manatu ina ia e le faʻafefiloi pe a suʻesuʻe.

Fa'atonuga a le gcloud CLI

A maeʻa ona faʻapipiʻi le Google Cloud CLI, amata ile:

gcloud init

E taua le fa'amautinoa o lo'o iai sau fa'amatalaga fou fa'atasi ma:

gcloud components update

Afai e te fa'aogaina se tu'uina atu fa'amatalaga mai fafo, Saini i totonu ma lou faasinomaga federated a'o le'i galue i le gcloud, aemaise lava pe afai o le a e fa'amaoni e fai REST vala'au mai lou si'osi'omaga. O fa'ata'ita'iga REST API e mafai ona fa'aogaina fa'amaoniga na e fa'atulagaina i le gcloud.

VM

Fa'atagaga ma matafaioi (Inisinia Compute): Ina ia faʻaopoopo, faʻafouina, pe tape metadata masani i luga o VM, e te manaʻomia faʻatagaga talafeagai IAM. O fa'ata'ita'iga masani e aofia ai:

  • Afai e fa'aoga e au VM tala o auaunaga: faatagaga iam.serviceAccounts.actAs i le auaunaga po'o le tala o galuega faatino.
  • Metadata o le poloketi: compute.projects.get y compute.projects.setCommonInstanceMetadata.
  • Fa'amatalaga fa'a-sona: compute.instanceSettings.get y compute.instanceSettings.update mo le vaega talafeagai.
  • Fa'ata'ita'iga metadata: compute.instances.get y compute.instances.setMetadata.

Tapulaa

O tapulaʻa autu ia na matou feagai pe a taumafai e aveese metadata ile Google Drive:

  • Fa'atapula'a Lapo'a (Mesinia Fa'akomepiuta): Ole aofa'iga tu'ufa'atasi o fa'amaumauga metadata e fa'agata ile 512 KB. O ki ta'itasi e fa'atapula'aina ile 128 paita, ma fa'agata ta'itasi ile 256 KB. Afai, mo se faʻataʻitaʻiga, e te faʻaogaina le ki ssh-keys ma sili atu i le 256 KB tapulaʻa, o le a le mafai ona e faʻaopoopoina nisi ki seʻi vagana ua e fufulu.
  • Mataitusi pito i luga ma mataitusi laiti: O ki e mata'itusi; tau foi, vagana ai Booleans. I le zonal, e le mafai ona e faia ni ki se lua e ese na'o le tulaga (zonal-metadata-key vs. ZONAL-METADATA-KEY).
  • Fa'amatalaga fa'a-sona: ua seti pe aveese e faaaoga ai le gcloud poo le REST. E le mafai ona e faʻamalamalamaina tulaga taua o le SSH (ssh-keys). I totonu o le poloketi / faʻatonuga, pe afai o loʻo i ai tulaga-tulaga ma le zonal tau mo le ki lava e tasi, o le tau o le zonal e faʻamuamua i lona sone.
  • Tulaga o le boolean lagolago: E fa'aopoopo i le TRUE/FALSE, e mafai ona e fa'aogaina Y/Ioe/1 ma le N/Leai/0 (mataupu e le maaleale).
  • Fuafuaga Va'aiga (Enisinia Compute):
    • Tusi: metadata masani i VM uma i le poloketi.
    • Zonal: fa'ailoga e a'afia uma ai VM i se sone fa'apitoa ma e mafai ona fa'asili le tau o le poloketi.
    • Fa'ata'ita'iga: metadata mo se VM patino (o loʻo faia pe ua uma ona iai).
Mea fa'apitoa - Kiliki i'i  E fa'afefea ona fa'amavae mai se Google potuaoga

Metadata ile Google Cloud

Ata fa'ata'ita'i, fa'asinomaga, ma su'ega metadata ile Drive (REST ma faiga sili ona lelei)

Se'i o tatou va'ava'ai i le sao o ata laititi pe a aveese metadata ile Google Drive. Ma o le auala sili foi e toe faʻaleleia ai:

  • Fa'amaoni mo le REST ile fale: Afai o loʻo e suʻeina faʻataʻitaʻiga REST mai lau masini, faʻaoga faʻamatalaga faʻamaonia ma gcloud. O le auala lea, o le a fa'aaloalogia e au valaau API Drive le fa'asinomaga ma fa'atagaga ua uma ona e setiina.
  • La'uina i luga o ata laiti fa'apitoa: seti contentHints.thumbnail ma ni fanua se lua: le ata URL-safe base64 ma le mimeType sa'o. Afai e mafai e le Drive ona fa'atupu otometi se la'ititi, o le a fa'aaoga e ia lava ma fa'amisi lau. A leai, o le a faʻaaogaina le mea e te tuʻuina atu.

Tulafono autu mo ata laiti ile Drive:

  • Fa'asologa: PNG, GIF po'o le JPG.
  • Fautuaina lautele: 1600 px (la'ititi 220 px).
  • Tele maualuga: 2MB.
  • Fa'afou le la'ititi i fa'asao ta'itasi pe a talafeagai pea.

Taua e uiga i fa'aleaogaina: E fa'aleaogaina ata pu'upu'u pe a suia mea o iai le faila; suiga metadata e leai. Afai e te suia na'o pine po'o le igoa, aua e te fa'amoemoe i se ata fou se'i vagana ua e suia le faila.

Fa'asinoga fa'asinomaga

Aua le taumafai e "faavalea" le suʻesuʻega i upu faʻafefe. Pu'e manatu ma faaupuga e su'e talafeagai e le tagata fa'aoga lena faila, ma siaki le tapulaa 128KB. Fa'afou pe a suia tele le anotusi.

Fa'aoga igoa ma fa'aopoopoga tutusaSo'o se taimi e mafai ai, fa'aaofia le fa'aopoopoga i le igoa pe a tu'uina atu; afai e misi, o le a taumafai Drive e fa'ailoa mai e MIME. O le fa'amanino o igoa o le a 'alofia ai fa'alavelave ma fa'afaigofie ai su'esu'ega fa'aopoopo.

Fa'ailoga ile Drive

Ina ia suia igoa, matau mea e iloagofie ai. E te mana'omia le fa'ailoga's labelId ma le faila faila. E mafai ona e lisi muamua i latou i files.listLabels ona fa'aoga lea o suiga talafeagai i le faila fa'atatau.

// 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.

Manatua lena, E ui o le Drive o le taulaiga, e tele atinaʻe e tuʻufaʻatasia le Drive ma le Cloud Storage poʻo isi auaunaga, O lea e te vaʻai ai i faʻataʻitaʻiga o le Teuina e siaki ai uiga o mea.

// 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
}

Aveese faila ma le tapeina o metadata ile Google Drive

Afai o le mea e te manaʻo ai o le tape se faila mai le DriveI le avea ai ma lē e ona, e mafai ona e fa'anofo i le lapisi mai le upega tafa'ilagi e ala ile kiliki-sa'o ma filifili le Move to Trash. Afai o le e ona o se isi tagata, e mafai ona e "aveese" le faila mai lau vaai; o le a mafai lava e isi ona vaai i ai.

Mea fa'apitoa - Kiliki i'i  Faʻafefea ona maua Google Photos mai Instagram

Para Ina ia tape tumau se faila, e tatau ona e sasaa le lapisi pe faʻaaoga le filifiliga tape tumau, I lenei tulaga, o le a le mafai ona e toe maua mai. O lenei, na'o ia, e le "ave'esea metadata" mai isi faila-e fa'aoga na'o lena mea.

E le mafai ona e tapeina metadata ile Google Drive mai faila e te le o iai, ona o la latou pule e a le tagata na faia i latou poʻo se tasi e maualuga atu faʻatagaga i totonu o le faʻalapotopotoga. I nei tulaga, na'o lou aveese o lou avanoa po'o le va'aia.

Fa'atatau ile metadata: O le tapeina o se faila e tape ai ana metadata i le Drive fa'atasi ai ma ia, ae e le afaina ai metadata i isi kopi poʻo metadata faʻapipiʻi i isi pepa o loʻo tumau i le faiga.

Faatasi ai ma mea uma o loʻo i luga, e mafai nei ona e vaʻaia lelei O le a le metadata Drive e pulea (igoa, pine, fa'ailoga su'esu'e, ma ata), fa'afefea ona fesiligia i latou e ala i le REST, o a faiga sili e mulimuli ai mo le fa'amamāina o fa'amaumauga fa'apipi'i a'o le'i tu'uina atu, ma po'o a tapula'a ma fa'atagaga e o'o mai pe a e mauaina fa'amaumauga a le Google Cloud e talanoa e uiga i "metadata" i isi tulaga.