Pag-tag ng tao at pagdagdag ng location sa Instagram post gamit ang API
Gamit ang user_tags, nagta-tag ng tao ang API ng Instagram, at gamit ang location_id, nagdaragdag ng location, na parehong itinatakda sa media container bago i-publish. Ang user_tags ay tumatanggap ng public na username, na may x at y na coordinates mula 0.0 hanggang 1.0 na kailangan sa mga larawan. Inilalarawan ito ng Meta para sa mga larawan, video, at Stories. Ang location_id ay tumatanggap ng ID ng isang Page na may location data, na mahahanap sa Pages Search API.
Nagpu-publish ang easyCoexistence ng mga larawan, carousel, Reels, at Stories gamit ang publish_instagram_post mula sa Claude, ChatGPT, o sariling code ninyo.
Saklaw ng x at y coordinates sa user_tags, sinusukat mula sa kaliwa at itaas na gilid ng larawan.
Saan kailangan ang x at y sa user_tags: kailangan sa larawan, opsyonal sa Stories, at naaangkop lamang sa larawan at Stories.
Hindi suportado ang location_id sa mga larawan o video sa loob ng carousel, ayon sa media reference ng Meta.
Ang config_issue value kapag na-publish ang media nang walang user tags, na tinatawag ng Meta na partial success.
Nang buksan ng Meta ang pag-tag ng location at public na Instagram user sa mga larawang na-publish sa API, una sa mga beta partner.
Paano mag-tag ng tao sa isang post?
Idagdag ang user_tags sa container. Ito ay isang array ng mga object, bawat isa ay may username ng isang public na Instagram account at, sa larawan, x at y: mga float mula 0.0 hanggang 1.0 na nagpapakita ng layo ng tag mula sa kaliwa at itaas na gilid. Ilagay ang location sa location_id sa parehong call, at pagkatapos ay i-publish ang container gamit ang media_publish gaya ng dati.
POST /<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/team.jpg",
"caption": "<CAPTION>",
"user_tags": [
{ "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
],
"location_id": "<PAGE_ID>"
}Aling post ang tumatanggap ng user tags at location?
Inilalarawan ng media reference ng Meta ang user_tags para sa larawan, video, at Stories, na ang x at y ay naaangkop lamang sa larawan at Stories, at inililista ang mga parameter na tinatanggap ng bawat container. Sa carousel, ilagay ang location sa carousel container, dahil hindi suportado ang location_id sa mga larawan o video sa loob nito:
Paano mahanap ang location_id?
Maghanap ng Page. Ang location_id ay ang ID ng Page na konektado sa isang location, at tinuturo ng reference ng Meta ang Pages Search API, ang GET /pages/search na may q at fields=id,name,location, pagkatapos ay ang pag-check na may location data ang napiling Page. Kapag walang ganitong data ang Page, mag-fail ito sa INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Tumatakbo ang search sa Graph API ng Meta gamit ang token ng sariling Meta app ninyo: user token, o para sa public na impormasyon ng Page, app token na may Page Public Metadata Access feature.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Ano ang mangyayari kung hindi ma-attach ang tag?
Maaari pa ring mai-live ang post. Ibabalik ng media_publish ang config_issue na may value na USER_TAGGING_FAILURE, na nangangahulugang na-publish ang media nang walang user tags. Tinatawag ito ng Meta na partial success at hinihiling sa mga app na ituring itong signal para mag-reconcile sa halip na error, dahil valid ang media ID; kapag nag-publish muli, magkakaroon ng pangalawang post.
Gumagana ba ang user tags sa Instagram Login?
Inililista ng media reference ng Meta ang user_tags at location_id para sa paggawa ng container nang hindi ito ikinakabit sa iisang login. Gayunman, sinasabi ng pahina nito para sa Instagram API with Instagram Login na hindi maa-access ng setup na iyon ang ads o tagging, nang hindi sinasabi kung anong tagging ang tinutukoy. Bago magtayo sa alinmang parameter gamit ang Instagram Login, mag-publish ng test post at i-check ang response at ang mismong post.
Paano mag-tag ng tao sa pamamagitan ng easyCoexistence?
Hindi pa magagawa. Ang publish_instagram_post mismo ang gumagawa ng container at walang user_tags o location_id, at hindi ipinamamahagi ang mga token ng Instagram para sa sarili ninyong call. I-publish ang post gamit ang publish_instagram_post, pagkatapos ay idagdag ang mga tag at ang lokasyon sa Instagram app, mula sa opsyong Edit ng post.
Mga karaniwang pagkakamali
- Pag-iwan ng x at y sa tag sa larawan. Kailangan ito ng Meta sa mga larawan; ang Stories lang ang may opsyonal na mga ito.
- Pagbibigay ng coordinates sa pixels o percent. Ang x at y ay float mula 0.0 hanggang 1.0, sinusukat mula sa kaliwa at itaas na gilid.
- Pagtatakda ng location_id sa carousel items. Hindi ito suportado ng Meta sa mga larawan o video sa loob ng carousel.
- Pag-tag sa private account. Ang user_tags ay tumatanggap lamang ng username ng mga public na Instagram account.
Walang user_tags o location_id ang tool, kaya ang mga tao at lugar ay tina-tag sa Instagram app, mula sa opsyong Edit ng post. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Pwede ko bang i-tag ang private na Instagram account sa pamamagitan ng API?
Hindi. Sinasabi ng media reference ng Meta na ang user_tags ay tumatanggap ng username ng mga public na Instagram account, kaya hindi maaaring i-tag ang private na account sa ganitong paraan.
Ilang tao ang maaaring i-tag sa isang post?
Walang maximum na nakasaad sa reference ng Meta para sa user_tags. Ang limit na 20 na nakasaad doon ay para sa @ tags sa caption.
Pwede ba akong magdagdag ng location sa Story sa pamamagitan ng API?
Hindi. Nakalista sa syntax ng Meta para sa Story container ang user_tags, pero hindi ang location_id.
Pwede ko bang i-tag ang product sa halip na tao?
Hiwalay na feature ang product tags, na nakalista sa overview ng Meta bilang suportado sa Facebook Login at Unified Login, hindi sa Instagram Login.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong