Sida loo tirtiro xogta badan ee Google Drive

Cusbooneysiintii ugu dambeysay: 18/08/2025

  • Faham waxa xogta badan ee Drive maamusha (magaca, tags, indexableText, iyo thumbnails) iyo waxa xogta badan leh ee adeegyada kale ee Google Cloud.
  • Isticmaal API Drive si aad u waydiiso oo aad u hagaajiso xogta badan; nadiifi EXIF ​​​​iyo xogta ku duugan ka hor inta aan la gelin faylasha.
  • Ixtiraamka xadka iyo qawaaniinta (thumbnails, qoraalka la tilmaami karo, kordhinta) oo ku xaqiiji gcloud ee tijaabada REST maxalliga ah.
tirtir xogta badan ee Google Drive

Ma rabtaa inaad xakamayso xogta badan ee faylashaada gudaha Google Drive oo ma garanaysaa meel laga bilaabo? Halkan waxaan ku sharaxay, si faahfaahsan, Sida looga saaro xogta badan ee Google Drive si hufan oo badbaado leh ( metadata ee faylasha la soo galiyay). Waxaan sidoo kale kuu sheegaynaa waxa xaddidaya Google-ku soo rogo magacyada faylka, cabbirrada, iyo oggolaanshaha.

Hagahan waxa uu ku siin doonaa faham dhamaystiran oo dhab ah oo ku saabsan waxa la “masixi karo” (iyo waxa aan la tirtiri karin) marka ay timaado xogta badan ee Google Drive.

Maxaa laga bedeli karaa ama "masixi karaa" Drive

Kuwani waa metadata kaas oo laga saari karo faylalka la geliyo Google Drive:

Magaca iyo kordhinta: Markaad abuureyso faylka API-ga, waa fikrad wanaagsan inaad ku qeexdo kordhinta goobta magaca, tusaale ahaan, "cat.jpg." Drive-ku wuxuu kordhin karaa nooca MIME haddii aadan cayimin, laakiin waxaa fiican inaad adigu qeexdo. Jawaabaha soo socda, faylka akhri-kaliya ayaa laga yaabaa inuu la soo baxo kordhinta magaca. Haddii isticmaaluhu soo dejiyo faylka, Drive wuxuu ka ururiyaa magaca ugu dambeeya ee cinwaanka (iyo kordhintiisa).

  • Qoraal la tilmaami karo (contentHints.indexableText): U wad dukumeentiyada iyo noocyada caanka ah (PDFs, sawirada OCR-karti, iwm.) si toos ah. Haddii abkaagu kaydiyo qaabab kale (sawiro, muuqaalo, jid-gaab), waxaad bixin kartaa qoraal la tilmaami karo si loo horumariyo raadinta. Qoraalkan waxa loo habeeyey HTML ahaan: haddii aad dhaafto xadhig ka kooban tags, nuxurka qoraalka ayaa la tix-geliyaa, ee maaha sifooyinka summada. Waxa jira xadka cabbirka 128KB ee contentHints.indexableText, waxaana lagugula talinayaa inaad cusboonaysiiso kayd kasta oo aad ka dhigto mid ku habboon faylka.
  • Tumbnails (contentHints.thumbnail): Drive-ku wuxuu soo saaraa thumbnails noocyo badan, laakiin qaababka aan si toos ah u soo saarin, waxaad geli kartaa adiga marka aad abuurto ama aad cusboonaysiiso faylka. Waa inaad u dejisaa sawirka URL-ammaan base64 iyo mimeType u dhigma. Xeerarka muhiimka ah: Qaababka la taageeray waa PNG, GIF, ama JPG; Balaadhka lagu taliyay waa 1600px (ugu yaraan 220px), cabirka ugu badana waa 2MB. Sawir-gacmeedku waa buray marka waxa faylka beddelo; isbeddellada metadata ma sameeyaan.
  • Helitaanka sawir-gacmeedka: Goobta ThumbnailLink waxay soo celinaysaa URL gaaban, oo la heli karo oo keliya haddii abka uu fasax u haysto inuu akhriyo faylka (haddii aanu ahayn mid dadweyne, waxaad u baahan doontaa inaad ku codsato aqoonsi). Waxaad ka codsan kartaa fayl gaar ah ama liis lagu sifeeyay nooca.
  • Summada: Drive-ku wuxuu kuu ogolaanayaa inaad ku xidhiddo sumadaha faylasha. Si aad u heshid, waxaad isticmaali kartaa files.listLabels, iyo si aad wax uga bedesho, waa inaad tixraacdaa summadaId iyo fileId u dhigma. Habkani wuxuu faa'iido u leeyahay kala soocida iyo, haddii loo baahdo, "nadiifinta" kala-soocida aan loo baahnayn iyada oo aan la taaban waxa ku jira.
Waxyaabaha gaarka ah - Riix Halkan  Gemini 2.5 Pro hadda waa bilaash: Waa kan sida Google-ka ugu dhammaystiran ee moodalka AI u shaqeeyo.
tirtir xogta badan ee Google Drive
Tirtir xogta badan ee Google Drive

Tirtir xogta badan ee Google Drive: xogta badan ee "qarsoon" ee faylka laftiisa

Ma jiro badhan sixir ah oo meesha ka saaraya xogta badan ee Google Drive (sida EXIF ​​​​in sawirada ama xogta ku dhex jirta PDFs). Drive wuxuu maamulaa xogtiisa badan, laakiin xogta badan ee ku jirta faylka waxay kuxirantahay aaladda abuurtay.

Dhaqanka lagu taliyay waa nadiifi faylka ka hor inta aanad gelin Drive, Isticmaalka aaladaha nidaamka ama abka khaaska ah ee ka saara xogta EXIF ​​​​ sawirada ama guryaha dukumeentiga. Sidan, waxa ku jira Drive-ka waxa aad ku kaydisay waxay ku imanaysaa "la nadiifiyey."

Haddii aad hore u haysatid faylal la soo galiyay xog badan oo ku guntan, halkii aad ka saari lahayd xogta badan ee Google Drive, way ku habboon tahay soo deji, nadiifi oo dib u soo rar, bedelida asalka haddii ay khuseyso. PDF-yada ama sawirada, tani waa caadi marka aad rabto inaad ilaaliso qoraaga, goobta, ama taariikhda tafatirka.

Qaybta gaarka ah ee Drive, diirada saara hagaajinta magaca, sumadaha iyo nuxurka Tilmaamaha (Text/thumbnail) kuwaas oo gacantaada ku jira. Haddii aad sidoo kale maamusho oggolaanshaha gelitaanka, waxa kale oo aad yaraynaysaa soo-gaadhista xogta badan ee muuqata (tusaale ahaan, xidhiidhada thumbnail ee ay heli karaan kuwa leh xuquuqda akhriska).

Ha iloobin taas Beddelka xogta badan ee Drive-ka kama saarayso EXIF ​​​​ama guryaha gudaha. Sidaa darteed, istaraatiijiyadaadu waa inay isku daraa nadiifinta hore ee faylka iyo maamulka xogta badan ee wanaagsan ee Drive-ku kuu ogolaanaya inaad taabato.

Xogta badan ee sida caadiga ah jahawareersan gudaha Google Cloud: VMs, gcloud, iyo xad

Haddii aad la shaqeyso Google Cloud, waxaad arki doontaa qaar badan hagaha ku saabsan "metadata" ee dhab ahaantii tixraacaya Matoorka Xisaabinta ama Kaydinta Cloud, ma aha Drive. Xitaa sidaas oo ay tahay, waxaad u baahan doontaa inaad ogaato qodobadan si aadan isugu dhex milmin markaad baadhayso.

Qaabeynta gcloud aasaasiga ah

Kadib rakibida Google Cloud CLI, ku bilow:

gcloud init

Waa muhiim inaad hubiso inaad haysato nuqulkii ugu dambeeyay:

gcloud components update

Haddii aad isticmaasho bixiye aqoonsi dibadeed, Ku gal aqoonsigaaga federaalka ka hor inta aanad la shaqayn gcloud, gaar ahaan haddii aad doonayso inaad xaqiijiso inaad wacdo REST ka soo waci karto deegaankaaga. Muunada REST API waxay isticmaali karaan aqoonsiga aad ku habaysay gcloud.

VMs

Ogolaanshaha iyo doorarka (Matoorka Xisaabinta): Si aad ugu darto, cusboonaysiiso, ama u tirtirto xogta badan ee VM-yada, waxaad u baahan tahay ogolaanshaha IAM ee habboon. Tusaalooyinka caadiga ah waxaa ka mid ah:

  • Haddii VM-yadaadu isticmaalaan akoonnada adeegga: fasax iam.serviceAccounts.actAs adeega ama xisaabta mashruuca.
  • Xogta badan ee mashruuca: compute.projects.get y compute.projects.setCommonInstanceMetadata.
  • Xogta badan ee aagga: compute.instanceSettings.get y compute.instanceSettings.update meesha ay khusayso.
  • Tusaalaha xogta badan: compute.instances.get y compute.instances.setMetadata.

Xadidyada

Kuwani waa xaddidaadaha ugu waaweyn ee aan la kulannay markii aan isku daynay inaan ka saarno xogta badan ee Google Drive:

  • Xaddidaadda Xajmiga (Matoorka Xisaabinta): Wadarta guud ee galitaanka xogta badan waxay ku koobnayd 512 KB. Fure kastaa wuxuu ku xaddidan yahay 128 bytes, qiime kastana wuxuu ku xaddidan yahay 256 KB. Haddii, tusaale ahaan, aad isticmaasho furaha ssh-keys oo aad dhaafto xadka 256 KB, ma awoodi doontid inaad furayaal badan ku darto ilaa aad nadiifiso.
  • Kiis sare iyo kiis hoose: Furayaashu waa kiis xasaasi ah; qiyamku waa sidoo kale, marka laga reebo Booleans. Soonalka, ma samayn kartid laba furayaal oo ku kala duwan haddii ay dhacdo (zonal-metadata-key vs. ZONAL-METADATA-KEY).
  • Xogta badan ee aagga: waa la dejiyay ama la saaray iyadoo la isticmaalayo gcloud ama REST. Ma qeexi kartid qiyamka aaga ee furayaasha SSH (furayaasha ssh-furayaasha). Mashruuca / tusaha macquulka ah, haddii ay jiraan heer-mashruuc iyo qiyamka aagga ee isla furaha, qiimaha aagga ayaa ka hormarinaya aaggeeda.
  • Qiimaha boolean ee la taageeray: Run/beenta ka sokow, waxaad isticmaali kartaa Y/Haa/1 iyo N/Maya/0 (kiis aan dareen lahayn).
  • Baaxadda Habayntu (Matoorka Xisaabinta):
    • Mashruuca: Xogta badan ee ka dhaxaysa dhammaan VM-yada mashruuca.
    • Aagga: gelisyada saameeya dhammaan VM-yada aag gaar ah oo burin kara qiimaha mashruuca.
    • Tusaale: Xogta badan ee VM gaar ah (la abuuray ama hore u jiray).
Waxyaabaha gaarka ah - Riix Halkan  Sida looga baxo xubinimada fasalka Google

Xogta badan ee Google Cloud

Sawir-gacmeedka, tusmaynta, iyo soo celinta xogta badan ee Drive (REST iyo hababka ugu fiican)

Aynu hadda eegno doorka thumbnails marka aan ka saarno xogta badan ee Google Drive. Iyo sidoo kale habka ugu wanaagsan ee lagu soo kabsado:

  • Xaqiijinta REST ee goobta: Haddii aad ka tijaabinayso tusaalayaal REST mashiinkaaga, isticmaal shahaadooyinka lagu habeeyey gcloud. Sidan, wicitaanadaada Drive API waxay ixtiraami doonaan aqoonsiga iyo oggolaanshaha aad mar hore dejisay.
  • Kordhinta thumbnail gaarka ah: dhigay contentTilmaamooyin.thumbnail leh laba goobood: URL-ammaan image base64 iyo mimeType saxda ah. Haddii Drive-ku si toos ah u soo saari karo thumbnail, wuxuu isticmaali doonaa kiisa oo wuu ka boodi doonaa kaaga. Haddii kale, waxay isticmaali doontaa midka aad bixiso.

Xeerarka muhiimka ah ee thumbnails gudaha Drive:

  • Qaababka: PNG, GIF ama JPG.
  • Balaadhka lagu taliyay: 1600 px (ugu yaraan 220 px).
  • Cabbirka ugu badan: 2MB.
  • Ku cusboonaysii thumbnail-ka kaydin kasta haddii ay weli khusayso.

Muhiim ah oo ku saabsan sharci darro: Sawir-gacmeedka ayaa bura marka waxa ku jira faylka la beddelo; isbeddellada xogta badan ma sameeyaan. Haddii aad beddesho tags ama magaca kaliya, ha filanin thumbnail cusub ilaa aad wax ka beddesho faylka.

Qoraal la tilmaami karo

Ha isku dayin inaad "nacas" raadinta ku xumayso erayo badan. Qabo fikradaha iyo ereyada uu isticmaaluhu si macquul ah u raadin doono faylkaas, iyo hubi xadka 128KB. Cusbooneysii mar kasta oo nuxurku isbeddelo.

Codso magacyada iyo kordhinta joogtada ahMar kasta oo ay suurtogal tahay, ku dar kordhinta magaca marka la soo gelinayo; haddii ay maqan tahay, Drive-ku waxa uu isku dayi doonaa in uu MIME ka eego. Magacyada oo la caddeeyo waxay ka fogaan doontaa madmadowga waxayna u oggolaanaysaa raadinta kordhinta sahlan.

Tags gudaha Drive

Si aad wax uga beddesho sumadaha, ogow aqoonsiga lagama maarmaanka ah. Waxaad u baahan doontaa calaamadda calaamadda iyo faylka faylka. Waxaad marka hore ku qori kartaa faylasha.listLabels ka dibna waxaad ku dabaqi kartaa isbeddelada u dhigma faylka bartilmaameedka.

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

Xusuusnow in, In kasta oo Drive uu yahay diiradda, horumaro badan ayaa ku dara Drive iyo Cloud Storage ama adeegyo kale, Markaa waxaad arki doontaa tusaalayaal Kaydinta si aad u hubiso sifooyinka shayga.

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

Tirtirka faylasha vs. tirtirida xogta badan ee Google Drive

Haddii aad rabto waa ka tirtir faylka DriveMulkiilaha ahaan, waxaad u rari kartaa qashinka shabakada adiga oo midigta gujinaya oo dooranaya U guuri qashinka. Haddii mulkiiluhu yahay qof kale, waxaad kaliya "ka saari kartaa" faylka aragtidaada; kuwa kalena weli way awoodi doonaan inay arkaan.

Waxyaabaha gaarka ah - Riix Halkan  Sida Google Sawirada looga galo Instagram

para Si aad si joogto ah u tirtirto faylka, waa inaad faaruqisaa qashinka ama aad isticmaashaa ikhtiyaarka tirtirka joogtada ah, Xaaladdan, ma awoodid inaad soo kabsato. Tani, lafteedu, kama "saarto xogta badan" faylalka kale-waxay khusaysaa shaygaas oo keliya.

Ma tirtiri kartid xogta badan ee ku jirta Google Drive faylalka aanad adigu lahayn, sababtoo ah maamulkooda waxaa iska leh qofka iyaga abuuray ama qof ruqsad sare ka haysta ururka dhexdiisa. Xaaladahan, waxaad si fudud meesha uga saaraysaa gelitaankaaga ama muuqaalkaaga.

La xidhiidha xogta badan: Tirtiridda faylka waxay tirtirtaa xogtiisa badan ee Drive-ka oo ay weheliso, laakiin ma saameynayso xogta badan ee nuqullada kale ama xogta badan ee ku duugan dukumentiyada kale ee ku hadhay nidaamka.

Dhammaan waxyaalaha kor ku xusan, waxaad hadda si fiican u kala saari kartaa Waa maxay xogta badan ee Drive-ku gacanta ku hayso (magaca, tagsyada, tilmaamida raadinta, iyo sawirka thumbnails), sida loo weydiiyo iyada oo loo marayo REST, waa maxay hababka ugu wanaagsan ee loo raaco nadiifinta xogta ku duugan ka hor inta aan la soo gelin, iyo waxa xaddidaadda iyo oggolaanshaha soo galaya marka aad la kulanto dukumeenti Google Cloud ah oo ka hadlaya "metadata" xaaladaha kale.