YouTube Analytics API sýnir áætlun — lokauppgjörið er aðeins í AdSense

Til að sækja áætlaðar tekjur eigin YouTube-rásar sendirðu reports.query-beiðni með OAuth-aðgangi, ids=channel==MINE, afmörkuðu tímabili og metrics=estimatedRevenue. Svarið gefur tekjuáætlun fyrir tiltæk gögn; það er ekki endanleg greiðslufjárhæð og því þarf að halda henni aðgreindri frá lokauppgjöri.

Tekjuleiðbeiningar YouTube segja að endanlegar tekjur birtist aðeins í AdSense for YouTube, geti verið aðrar en áætlaðar tekjur í Analytics og bætist við stöðu reiknings fyrir fyrri mánuð á tímabilinu 7.–12. dag næsta mánaðar. Berðu því saman sama tekjumánuð í báðum kerfum þegar uppgjörið hefur verið fært, ekki núverandi stöðu reikningsins við nýjustu API-töluna.

Auðkenning sem opnar tekjumæligildið

Virkjaðu YouTube Analytics API í Google Cloud-verkefni og settu upp OAuth-samþykki og OAuth-auðkenni fyrir forritið. Eigandi rásarinnar heimilar síðan forritinu að lesa gögn sín; API-lykill án samþykkis eigandans dugar ekki fyrir þessa fyrirspurn. Heimildin yt-analytics-monetary.readonly veitir aðgang að tekju- og auglýsingamæligildum, en lýsing aðferðarinnar krefst nú líka youtube.readonly. Bættu báðum heimildum við samþykkisbeiðnina áður en þú reynir að sækja estimatedRevenue.

Settu aðgangslykil innskráðs eiganda í Authorization-haus beiðninnar sem Bearer-lykil. Ef um fleiri en eina rás er að ræða er auðkenningin sjálf hluti af afstemmingunni: ids=channel==MINE vísar til rásar þess notanda sem veitti aðgang, en ids=channel==CHANNEL_ID á aðeins við um auðkenni rásar sem sá notandi hefur aðgang að. Varðveittu tengslin milli rásar og svara svo fjárhæð eins höfundar blandist ekki inn í uppgjör annars.

Fyrirspurn fyrir afmarkaðan mánuð

Sendu GET-beiðni á /v2/reports með nauðsynlegu breytunum ids, startDate, endDate og metrics. Ef þú vilt eina heildartölu fyrir rásina á tímabilinu sleppirðu dimensions; með dimensions=day færðu sundurliðun eftir dögum. Gjaldmiðill er valfrjáls beiðnibreyta en skiptir máli þegar svar á að fara í fjárhagslegt yfirlit.

1. Veldu rásina með ids=channel==MINE eftir að rétti eigandi hefur veitt OAuth-heimild.
2. Settu startDate á fyrsta dag mánaðarins og endDate á síðasta dag sama mánaðar, hvort tveggja á forminu YYYY-MM-DD.
3. Settu metrics=estimatedRevenue. Veldu currency með studdum þriggja stafa gjaldmiðilskóða ef þú þarft annan gjaldmiðil en sjálfgefinn USD.
4. Sendu fyrst beiðni án dimensions fyrir mánaðarsamtölu og, ef þarf að sjá hvaða dagar liggja að baki henni, aðra með dimensions=day og sort=day.

Skilyrt dæmi fyrir ágúst 2026 væri ids=channel==MINE; startDate=2026-08-01; endDate=2026-08-31; metrics=estimatedRevenue; currency=USD. Þetta eru aðeins beiðnibreytur, ekki gögn um raunverulegar tekjur. Daglega fyrirspurnin þarf sömu rás, tímamörk, mæligildi og gjaldmiðil svo sundurliðunin útskýri sömu mánaðaráætlun og fyrri beiðnin.

currency stýrir birtingu áætlaðra tekjumæligilda; API-ið notar gengi sem getur verið breytilegt eftir dögum. USD er sjálfgefinn gjaldmiðill og ISK er ekki á lista studdra gilda fyrir þessa breytu. Íslenskur höfundur ætti því að geyma gjaldmiðil með fjárhæðinni og forðast að birta USD-tölu með krónumerki. Ef AdSense-reikningurinn notar annan gjaldmiðil þarf að meðhöndla gjaldmiðilsmuninn sérstaklega áður en fjárhæðir eru bornar saman.

Síðasti gagnadagur er ekki endDate

endDate afmarkar beiðnina en tryggir ekki að tekjugögn hafi borist fyrir allan mánuðinn. Svarið nær aðeins til síðasta dags sem öll umbeðin mæligildi eru tiltæk; dagleg sundurliðun getur því endað fyrr en endDate. Vanti nýjustu dagana í rows er ekki rétt að túlka þá sem tekjulausa daga. Ef engin gögn eru tiltæk fyrir fyrirspurnina getur rows alveg vantað í svarið.

Mánaðarsvar án dimensions sýnir samanlagða fjárhæð en segir ekki sjálft hvaða dagur var síðast tiltækur. Daglega aukabeiðnin gerir þann mun sýnilegan: finndu síðasta daginn í rows og merktu mánaðartöluna ófullkomna ef hann er fyrir endDate. Sæktu sama tímabil aftur þegar fleiri dagar hafa bæst við og geymdu tímann sem hver útgáfa áætlunarinnar var sótt. Þannig verður seinni breyting á tölu ekki ranglega túlkuð sem nýr tekjumánuður.

Afstemming við AdSense for YouTube

Þegar lokatekjur fyrri mánaðar hafa færst í AdSense for YouTube skaltu bera þær saman við estimatedRevenue fyrir sömu rás og sama almanaksmánuð. Skráðu tekjutímabilið, rásarauðkennið, fjárhæð og gjaldmiðil úr API, síðasta tiltæka gagnadag og daginn sem áætlunin var sótt. Fyrir AdSense-hliðina skráirðu endanlega fjárhæð þess mánaðar og gjaldmiðil hennar. Þá sést hvort munur var þegar til staðar í fullum mánuði eða stafaði fyrst af vantaðum dögum.

Áætlun getur breyst vegna leiðréttinga á umferð, höfundarréttarkröfum eða auglýsingaherferðum; staðgreiðsla skatta getur einnig haft áhrif á lokatekjur þegar hún á við. Hafðu slíkar skýringar aðgreindar frá gjaldmiðilsmun og frá einfaldri töf í gagnasöfnun. Núverandi reikningsstaða og síðasta útborgun lýsa ekki sjálfkrafa tekjum þess mánaðar sem API-beiðnin nær yfir. Þar skipta afmarkaður tekjumánuður og viðeigandi lokafærsla meira máli en heildarstaðan á tilteknum degi.

Í sjálfvirku yfirliti er skynsamlegt að halda eftir tveimur gildum fyrir lokaðan mánuð: síðustu varðveittu API-áætluninni og endanlegum tekjum úr AdSense. Reiknaðu frávikið aðeins þegar báðar fjárhæðir ná yfir sama tímabil og eru í sambærilegum gjaldmiðli. Uppfærð áætlun má ekki yfirskrifa lokatöluna; annars hverfur munurinn sem afstemmingin á að sýna.

Hvenær Reporting API á við

Samanburður Google á API-leiðunum greinir á milli markvissra fyrirspurna í YouTube Analytics API og fyrirfram skilgreindra heildarskýrslna í YouTube Reporting API. Reporting API byggir á skýrsluverkefnum og daglegum niðurhölum sem henta magnvinnslu; í Analytics-fyrirspurn velurðu sjálfur tímabil og mæligildi. Fyrir afstemmingu eins mánaðar er beina fyrirspurnin því einfaldari leið, en val á gagnaöflun breytir ekki stöðu estimatedRevenue sem áætlunar.

Lestu einnig:

• Eigin mállíkan var dýrara en API — skyndiminni sneri kostnaðinum við
• AlloyDB einangrar gagnagrunn fyrir hvern fulltrúa — en aðeins í forskoðun
• Pandektes fær 13,5 milljónir evra — API-ið verður næsta veðmál