v1Recursos/Posts/patchAtualizar uma publicação

Atualizar uma publicação

Atualização parcial de um post editável (draft, scheduled, paused, partial, error ou active): os campos que você não envia não mudam, e as listas enviadas substituem a lista existente. Um rascunho continua rascunho; para publicá-lo envie draft: false ou um scheduledFor futuro, ou chame POST /api/v1/posts/{id}/publish. Editar um post no ar o atualiza nas plataformas, exceto que um post no ar no Facebook não pode mudar imagens, carrossel nem botão (422); mudar o agendamento de um post no ar retorna 409. Retorna o post como GET /api/v1/posts/{id}, com targets.

patch/api/v1/posts/{id}

posts:write

Parâmetros de consulta

idstringobrigatório

A publicação a ser atualizada.

Corpo da solicitação

locationIdstringopcional

O local para o qual publicar. Forneça este ou clientId.

clientIdstringopcional

O cliente para o qual publicar em nível de marca. Forneça este ou locationId.

namestringopcional

Nome/rótulo interno da publicação. Obrigatório, não pode ser vazio.

postTypestring (announcement | event | offer)opcional

Tipo de publicação. event e offer são exclusivos do Google.

Plataformas de destino. Envie isto ou connectionIds. Cada plataforma publica pela conexão do local para ela (ou do cliente, em uma publicação de marca).

connectionIdsarray of stringopcional

Destinos exatos: os ids de conexão nos quais publicar, de GET /api/v1/locations/{id}/publish-targets. Use a conexão do próprio local ou a página de marca do cliente dele; uma conexão do Google em nível de conta, uma arquivada ou uma de outro local ou cliente é rejeitada com 422. Se enviado, o post vai exatamente para esses destinos e platforms é obtido deles. Na atualização, a lista substitui os destinos do post.

linkUrlstringopcional

O link principal do post, usado por cada plataforma que exibe um.

linkCtaKeystringopcional

O botão exibido com linkUrl, por exemplo learn_more, book ou shop.

utmobjectopcional

Tags UTM (source, medium, campaign, term) adicionadas ao linkUrl.

sourcestringopcional

mediumstringopcional

campaignstringopcional

termstringopcional

linkOverrideobjectopcional

Configurações de link por plataforma, com chave por plataforma: outra url, botão, title, description ou utm para essa plataforma.

linkAppendobjectopcional

Se o linkUrl é adicionado ao fim da legenda no X e no Mastodon, que não têm campo de link.

xbooleanopcional

mastodonbooleanopcional

ctaUrlFacebookstringopcional

URL do botão só para o Facebook, quando deve ser diferente de ctaUrl.

xThreadbooleanopcional

No X, divide uma legenda maior que um post em uma thread.

scheduleLocalTimestringopcional

Agenda pelo horário local, "YYYY-MM-DDTHH:mm" sem fuso. Use no lugar de scheduledFor para agendamento por fuso horário.

scheduleZoneModestring (target_local | fixed_zone)opcional

Como scheduleLocalTime é lido: target_local publica nesse horário no fuso de cada destino; fixed_zone usa scheduleTimeZone para todos os destinos.

scheduleTimeZonestringopcional

Fuso horário IANA para agendamento fixed_zone, por exemplo "America/New_York".

timeZoneModestring (target_local | fixed_zone)opcional

O mesmo que scheduleZoneMode.

articleTitlestringopcional

Campos de artigo para Medium e Substack: título, subtítulo e corpo em HTML.

articleSubtitlestringopcional

Campos de artigo para Medium e Substack: título, subtítulo e corpo em HTML.

articleBodyHtmlstringopcional

Campos de artigo para Medium e Substack: título, subtítulo e corpo em HTML.

canonicalUrlstringopcional

URL original de um artigo publicado em outro lugar, para que a plataforma credite a fonte.

videoCoverUrlstringopcional

Opções de vídeo: a URL de uma imagem de capa e a URL de um arquivo de legendas com o idioma.

videoCaptionsUrlstringopcional

Opções de vídeo: a URL de uma imagem de capa e a URL de um arquivo de legendas com o idioma.

videoCaptionsLanguagestringopcional

Opções de vídeo: a URL de uma imagem de capa e a URL de um arquivo de legendas com o idioma.

facebookCaptionstringopcional