Meriv çawa metadata li Google Drive-ê jê dibe

Ma tu dixwazî ​​metadatayên pelên xwe kontrol bikî? Google Drive û nizanin ji ku dest pê bikin? Li vir em bi berfirehî rave dikin, Meriv çawa metadata li Google Drive bi bandor û bi ewlehî jê dibe (metadata pelên barkirî). Em her wiha ji we re vedibêjin ka Google çi sînoran li ser nav, mezinahî û destûran ferz dike.

Ev rêber dê têgihîştineke bêkêmasî û rastîn a tiştên ku dikarin (û nayên) "jêbirin" dema ku dor tê ser metadatayên di Google Drive de, bide we.

Di Drive de çi dikare were guhertin an "jêbirin"

Ev in metadata ku dikare ji pelên ku li ser Google Drive-ê hatine barkirin werin rakirin:

Nav û dirêjkirin: Dema ku hûn pelek bi rêya API-yê diafirînin, fikrek baş e ku hûn dirêjkirinê di qada navî de diyar bikin, mînakî, "cat.jpg". Ger hûn wê diyar nekin, Drive dikare dirêjkirinê ji celebê MIME texmîn bike, lê çêtir e ku hûn wê bi xwe diyar bikin. Di bersivên paşîn de, pelek tenê-xwendinê dikare bi dirêjkirina ji navî were xuya kirin. Ger bikarhênerek pelê dakêşîne, Drive navê dawîn ji sernavê (û dirêjkirina wê) berhev dike.

• Nivîsara endeksbar (contentHints.indexableText): Drive belge û celebên hevpar (PDF, wêneyên OCR-çalakkirî, hwd.) bi xweber navnîş dike. Ger sepana we formatên din (wêne, vîdyo, kurtebir) tomar bike, hûn dikarin nivîsa navnîşkirî peyda bikin da ku lêgerînê baştir bikin. Ev nivîs wekî HTML tê pêvajo kirin: heke hûn rêzek ku etîketan dihewîne derbas bikin, naveroka nivîsê tê navnîş kirin, ne taybetmendiyên etîketê. Ji bo contentHints.indexableText sînorek mezinahiya 128KB heye, û tê pêşniyar kirin ku hûn wê di her tomarkirinê de nûve bikin û wê bi pelê ve girêdayî bihêlin.
• Wêneyên piçûk (contentHints.thumbnail): Drive ji bo gelek celeb wêneyan piçûk çêdike, lê ji bo formatên ku wan bixweber çênakin, hûn dikarin dema ku hûn pelê diafirînin an nûve dikin, yên xwe bar bikin. Divê hûn wêneyê li ser URL-safe base64 û mimeType-ya têkildar saz bikin. Rêgezên sereke: Formatên piştgirîkirî PNG, GIF, an JPG ne; firehiya pêşniyarkirî 1600px (herî kêm 220px) e, û mezinahiya herî zêde 2MB ye. Wêneyên piçûk dema ku naveroka pelê diguhere betal dibin; guhertinên metadatayê naguherin.
• Gihîştina wêneyên piçûk: Zeviya ThumbnailLink URL-yek kurt vedigerîne, ku tenê heke destûr hebe ku sepan pelê bixwîne dikare bigihîje wê (eger ne giştî be, hûn ê hewce bikin ku bi bawernameyan daxwaz bikin). Hûn dikarin ji bo pelek taybetî an ji bo navnîşek ku li gorî celebê hatiye fîltrekirin bipirsin.
• Etîket: Drive dihêle hûn etîketan bi pelan ve girêbidin. Ji bo dîtina wan, hûn dikarin files.listLabels bikar bînin, û ji bo guhertina wan, divê hûn li labelId û fileId-ya têkildar binêrin. Ev mekanîzma ji bo kategorîzekirin û, ger hewce be, "paqijkirina" dabeşkirinên nexwestî bêyî destdayîna naverokê kêrhatî ye.

Metadata di Google Drive de jê bibe: metadata "veşartî" ji pelê bixwe

Ji bo rakirina metadatayan di Google Drive de bişkokek efsûnî tune ye (wek EXIF ​​​​di wêneyan de an daneyên çandî di PDF-an de). Drive metadatayên xwe birêve dibe, lê metadatayên di nav pelê de bi amûra ku ew çêkiriye ve girêdayî ye.

Pratîka pêşniyarkirî ev e berî barkirina pelê li ser Drive-ê paqij bike, Bi karanîna amûrên pergalê an sepanên taybetî ku daneyên EXIF ​​​​ji wêne an taybetmendiyên belgeyan radikin. Bi vî rengî, naveroka ku hûn di Drive-ê de tomar dikin "paqijkirî" digihîje.

Heke pelên we yên bi metadatayên çandî barkirî hebin, li şûna rakirina metadatayên di Google Drive de, ew hêsantir e. daxistin, paqijkirin û ji nû ve barkirin, ger pêkan be, guhertina ya orîjînal. Bi PDF an wêneyan re, ev gelemperî ye dema ku hûn dixwazin nivîskarî, cîh, an dîroka guherandinê biparêzin.

Ji bo beşa taybetî ya Drive, balê bikişîne ser sererastkirina nav, etîket û nîşaneyên naverokê (nivîs/thumbnail a ku dikare were nîşankirin), ku di bin kontrola we de ne. Ger hûn destûrên gihîştinê jî birêve bibin, hûn eşkerekirina metadatayên xuya jî kêm dikin (mînakî, girêdanên wêneyên piçûk ên ku ji bo kesên xwedî mafên xwendinê gihîştinê hene).

Wê yekê ji bîr mekin Tenê guhertina metadataya Drive-ê EXIF ​​​​an taybetmendiyên navxweyî jê nabe. Ji ber vê yekê, stratejiya we divê pêş-paqijkirina pelê bi rêveberiya metadata ya hûr-grained ku Drive dihêle hûn dest lê bidin re bike yek.

Metadatayên ku bi gelemperî di Google Cloud de têne tevlihevkirin: VM, gcloud, û sînorkirin

Heke hûn bi Google Cloud re bixebitin, hûn ê gelekan bibînin rêbernameyên li ser "metadata" ku di rastiyê de behsa Compute Engine an Cloud Storage dikin, ne Drive. Her çiqas wisa be jî, hûn ê bixwazin van xalan bizanibin da ku hûn di dema lêkolînê de wan tevlihev nekin.

Mîhengkirina bingehîn a CLI ya gcloud

Piştî sazkirina Google Cloud CLI, bi vê yekê dest pê bike:

gcloud init

Girîng e ku hûn pê ewle bin ku we guhertoya herî dawî heye:

gcloud components update

Heke hûn pêşkêşvanek nasnameya derveyî bikar tînin, Berî ku hûn bi gcloud re bixebitin, bi nasnameya xwe ya federasyonkirî têkevinê, bi taybetî heke hûn ê ji bo kirina bangên REST ji jîngeha xweya herêmî rastnivîsê bikin. Nimûneyên API-ya REST dikarin pêbaweriyên ku we di gcloud de mîheng kirine bikar bînin.

VMs

Destûr û rol (Motora Hesabkirinê): Ji bo zêdekirin, nûvekirin, an jêbirina metadatayên xwerû li ser VM-an, hûn hewceyê destûrên IAM-ê yên guncaw in. Nimûneyên hevpar ev in:

• Heke VM-yên we hesabên xizmetê bikar tînin: destûra iam.serviceAccounts.actAs di hesabê xizmet an projeyê de.
• Metadata projeyê: compute.projects.get y compute.projects.setCommonInstanceMetadata.
• Metadata herêmî: compute.instanceSettings.get y compute.instanceSettings.update ji bo herêma têkildar.
• Metadataya nimûneyê: compute.instances.get y compute.instances.setMetadata.

Sînor

Ev sînorkirinên sereke ne ku me dema ku hewl dida metadata di Google Drive de jê bibin rastî wan hatin:

• Sînorkirinên Mezinahîyê (Motora Hesabkirinê): Mezinahiya giştî ya tomarên metadatayê bi 512 KB ve hatiye sînordarkirin. Her mifteyek bi 128 byte ve sînordar e, û her nirxek bi 256 KB ve sînordar e. Mînakî, heke hûn mifteya ssh-keys bikar bînin û ji sînorê 256 KB derbas bibin, hûn ê nikaribin mifteyên din lê zêde bikin heya ku hûn paqij nekin.
• Rewşa jorîn û ya jêrîn: Bişkok ji bo mezin û biçûkan hesas in; nirx jî hesas in, ji bilî Boolean. Di zonal de, hûn nekarin du bişkokan biafirînin ku tenê ji hêla mezin û biçûkan ve ji hev cuda bin (zonal-metadata-key vs. ZONAL-METADATA-KEY).
• Metadata herêmî: bi karanîna gcloud an REST têne danîn an rakirin. Hûn nekarin nirxên herêman ji bo mifteyên SSH (ssh-keys) destnîşan bikin. Di proje/pelrêça mentiqî de, heke nirxên asta projeyê û herêman ji bo heman mifteyê hebin, nirxa herêman di herêma xwe de pêşîniyê digire.
• Nirxên boolean ên piştgirîkirî: Ji bilî TRUE/FALSE, hûn dikarin Y/Erê/1 û N/Na/0 (bi mezinbûn û biçûkbûnan ​​re hesas) bikar bînin.
• Qadên Mîhengkirinê (Motora Hesabkirinê):
  • Rêvename: metadata hevpar ji bo hemî VM-yên di projeyê de.
  • Zonal: têketinên ku bandorê li hemî VM-yan li herêmek taybetî dikin û dikarin nirxa projeyê biguherînin.
  • Nimûne: metadata ji bo VM-yek taybetî (ku tê afirandin an jî jixwe heye).

Wêneyên piçûk, endekskirin, û vegerandina metadatayê di Drive de (REST û baştirîn pratîk)

Niha em li rola wêneyên piçûk dema rakirina metadatayan li Google Drive binêrin. Û her weha rêya herî baş ji bo vegerandina wan:

• Pejirandina rastkirinê ji bo REST li ser cih: Eger hûn nimûneyên REST ji makîneya xwe diceribînin, bawernameyên ku bi gcloud ve hatine mîheng kirin bikar bînin. Bi vî rengî, bangên API-ya we ya Drive dê nasname û destûrên ku we berê destnîşan kirine rêz bigirin.
• Barkirina wênekêşiya xwerû: contentHints.thumbnail bi du zeviyan saz bike: wêneya base64 ya URL-ewle û mimeType ya rast. Ger Drive bikaribe bixweber wêneyek piçûk çêbike, ew ê ya xwe bikar bîne û ya te derbas bike. Wekî din, ew ê ya ku hûn peyda dikin bikar bîne.

Rêgezên sereke ji bo wêneyên piçûk di Drive de:

• Format: PNG, GIF an JPG.
• Firehiya pêşniyarkirî: 1600 px (herî kêm 220 px).
• Mezinahiya herî zêde: 2 MB.
• Heke hîn jî têkildar be, wêneyê piçûk bi her tomarkirinê re nûve bike.

Girîng derbarê betalkirin: Dema ku naveroka pelê tê guhertin, wêneyên piçûk betal dibin; guhertinên metadatayê naguherin. Ger hûn tenê etîketan an nav biguherînin, heya ku hûn pelê neguherînin, li bendê nebin ku wêneyên piçûk ên nû derkevin.

Nivîsa ku dikare were endekskirin

Hewl nedin ku lêgerînê bi peyvên populer "bixapînin". Têgeh û peyvên ku bikarhênerek dê bi awayekî maqûl ji bo wê pelê bigere, bigirin, û sînorê 128KB kontrol bike. Her gava ku naverok bi girîngî biguhere, wê nûve bikin.

Nav û dirêjkirinên hevgirtî bicîh bîninHer gava ku gengaz be, dema barkirinê dirêjkirin di nav de bicîh bikin; heke ew winda be, Drive dê hewl bide ku wê bi MIME texmîn bike. Zelalkirina navan dê ji nezelaliyan dûr bisekine û lêgerînên dirêjkirinan hêsantir bike.

Etîketên di Drive de

Ji bo guhertina etîketan, nasnameyên pêwîst tomar bikin. Hûn ê hewceyê labelId-ya etîketê û fileId-ya pelê bin. Hûn dikarin pêşî wan bi files.listLabels navnîş bikin û dûv re guhertinên têkildar li ser pelê hedef bicîh bînin.

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

Bînin bîra xwe ku, Her çend Drive balê dikişîne jî, gelek pêşketin Drive bi Cloud Storage an karûbarên din re dikin yek, Ji ber vê yekê hûn ê mînakên Depokirinê bibînin da ku taybetmendiyên tiştan vekolin.

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

Jêbirina pelan li hember jêbirina metadatayan li Google Drive

Ku hûn dixwazin pelê ji Drive jê bibeWekî xwediyê wê, hûn dikarin wê ji webê veguhezînin çopê bi tikandina rastê ya mişkê û hilbijartina Veguheztin bo Çopê. Ger xwediyê wê kesek din be, hûn tenê dikarin pelê ji dîtina xwe "Rakin"; yên din hîn jî dê bikaribin wê bibînin.

para Ji bo ku hûn pelek bi awayekî daîmî jê bibin, divê hûn çopê vala bikin an jî vebijarka jêbirina daîmî bikar bînin, Di vê rewşê de, hûn ê nikaribin wê vegerînin. Ev, bi serê xwe, "metadatayan" ji pelên din ranake - ew tenê ji bo wê tiştî derbas dibe.

Tu nikarî metadatayên li Google Drive ji pelên ku ne xwediyê te ne jê bibî, ji ber ku kontrola wan aîdî kesê ku wan afirandiye an jî ya kesekî/ê xwedî destûrên bilindtir di nav rêxistinê de ye. Di van rewşan de, hûn tenê gihîştin an dîtina xwe radikin.

Girêdana wê bi metadatayê re: Jêbirina pelekê metadataya wê ya li Driveê jî pê re jê dibe, lê ew bandorê li metadatayên di kopiyên din de an jî metadatayên çandî di belgeyên din de nake ku di pergalê de dimînin.

Bi van hemû tiştên jorîn, hûn dikarin êdî baş ji hev cuda bikin. Kîjan metadata kontrolên Drive (nav, etîket, nîşanên lêgerînê, û wêneyên piçûk), çawa bi rêya REST-ê lêpirsîna wan bê kirin, ji bo paqijkirina daneyên çandî berî barkirinê çi rêbazên çêtirîn werin şopandin, û dema ku hûn rastî belgeyên Google Cloud-ê tên ku di çarçoveyên din de behsa "metadata" dikin çi sînor û destûr têne bikaranîn.