Skip to main content

Publicando um Pin de imagem no Pinterest

A API do Pinterest exige que uma imagem seja incluída na publicação. Outros parâmetros são opcionais. Consulte as Diretrizes de mídia do Pinterest e a Autorização do Pinterest para mais informações.
Pinterest Post

Opções do Pinterest

Você pode definir opções adicionais para uma publicação usando o parâmetro pinterestOptions.
Pinterest Post
As opções do Pinterest são campos opcionais que podem ser usados para controlar a publicação.
array of strings
O texto alternativo para imagens e vídeos, voltado para acessibilidade e leitores de tela. Máximo de 500 caracteres.Consulte Texto alternativo do Pinterest para mais informações.
array of strings
Declare divulgações de IA para o Pin inteiro. Os valores aceitos são AI_MODIFIED e SYNTHETIC_PERFORMER.Consulte Divulgações de IA do Pinterest para mais informações.
string
Publique em outro Pinterest Board do usuário especificando o ID do endpoint /user/details.Se não for especificado, publica no board vinculado por padrão.Consulte Pinterest Board ID para mais informações.
Adicione até 5 imagens como um carrossel do Pinterest com títulos, links e descrições opcionais.Cada objeto pode conter: title, link e description.Consulte Carrossel de imagens do Pinterest para mais informações.
A URL de destino para a qual os usuários serão direcionados ao clicarem na imagem do Pin. Máximo de 2048 caracteres.Cria um link clicável associado ao seu Pin.Consulte Pin Link para mais informações.
string
Adicione notas privadas a Pins individuais que só você e os colaboradores do board podem ver. Máximo de 1000 caracteres.Consulte Pin Note para mais informações.
string
Define uma thumbnail para Pins de vídeo. Deve ser PNG ou JPG, com as mesmas dimensões do vídeo, com menos de 10MB.Obrigatório para Pins de vídeo.Consulte Pin de vídeo (Thumbnail) para mais informações.
string
O título do Pin exibido na seção “Add your title”. Máximo de 100 caracteres.Consulte Pin Title para mais informações.
*Links no campo post não são clicáveis. Use o campo link para adicionar um link clicável ao Pin. Consulte as Diretrizes de mídia do Pinterest para mais informações.

Texto alternativo

Adicione texto alternativo (alt text) a uma imagem ou vídeo do Pinterest. O alt text do Pinterest é um recurso de acessibilidade usado para fornecer informações adicionais ao usuário e para leitores de tela. Use altText no objeto pinterestOptions.
Pinterest Alt Text
O alt text é limitado a 500 caracteres.

Divulgações de IA do Pinterest

Use pinterestOptions.aiDisclosures para enviar as declarações de divulgação de IA do Pinterest ao criar um Pin. As divulgações se aplicam ao Pin inteiro, incluindo carrosséis de imagens, e são suportadas em Pins de imagem, Pins de carrossel e Pins de vídeo.
Pinterest AI Disclosure
Você pode enviar os dois valores aceitos juntos:
Pinterest AI Disclosure
Valores aceitos:
  • AI_MODIFIED: o Pin contém conteúdo modificado por IA.
  • SYNTHETIC_PERFORMER: o Pin contém um artista sintético.
Se aiDisclosures for omitido ou for um array vazio, o Ayrshare não envia ao Pinterest nenhum campo de divulgação de IA. Valores duplicados são enviados uma única vez. Os valores diferenciam maiúsculas de minúsculas e não são convertidos. Se a opção for inválida, por exemplo um valor desconhecido, maiúsculas/minúsculas incorretas, um valor que não seja array ou um array contendo uma entrada que não seja string, o Pin ainda pode ser publicado com sucesso, mas o Ayrshare omite toda a opção de divulgação e retorna um aviso não fatal no resultado do Pinterest. Corrija a requisição e envie um ou ambos os valores aceitos se o Pin precisar de uma divulgação de IA explícita. O Pinterest ainda pode aplicar seus próprios rótulos de forma independente. O servidor MCP e a API GraphQL verificam primeiro os tipos dos valores. Nessas interfaces, um valor malformado, como uma lista contendo um número, é rejeitado antes da publicação, em vez de ser publicado com um aviso. Strings desconhecidas ou com maiúsculas/minúsculas incorretas ainda são publicadas com o aviso.

ID do Board

Publique em outro Pinterest Board do usuário especificando o ID obtido do endpoint /user/details. Caso contrário, publica no board vinculado por padrão. Use boardId no objeto pinterestOptions.
Pinterest Board ID

Limites de caracteres

Consulte Limites de caracteres do Pinterest para mais informações. A URL de destino para a qual os usuários serão direcionados ao clicarem na imagem do Pin. Isso cria um link clicável associado ao seu Pin. Tamanho máximo de 2048 caracteres. Use link no objeto pinterestOptions.
Pin Link

Pin Note

Você pode adicionar notas privadas a Pins individuais em seus boards. Apenas você e os colaboradores do board poderão vê-las. Use note no objeto pinterestOptions.
Pin Note
Publique até cinco imagens como um carrossel do Pinterest. Ao adicionar mais de uma URL de mídia, um carrossel é criado automaticamente. Você também pode adicionar parâmetros opcionais do carrossel. Veja abaixo.
Pinterest Carousel Post
O campo opcional carouselOptions recebe um array de objetos. Cada objeto do carrossel corresponde à string equivalente na URL de mídia; por exemplo, o primeiro objeto do carrossel se refere à primeira string mediaUrl.
  • title: O título da imagem.
  • link: O link de destino externo da imagem.
  • description: A descrição da imagem.

Menções no Pinterest

Embora você possa adicionar um @handle a uma publicação do Pinterest, o Pinterest não suporta a resolução de menções no texto da publicação. O @handle permanecerá como texto simples.

Pin Title

O título do Pin a ser exibido. Aparece na seção “Add your title” de um novo Pin. Máximo de 100 caracteres. Use title no objeto pinterestOptions.
Pin Title

Pin de vídeo (Thumbnail)

Um vídeo pode ser publicado como Pin usando o campo padrão mediaUrls no endpoint /post. Além disso, uma URL de imagem de thumbnail deve ser incluída com o vídeo, com um Content-Type de mídia válido, como image/jpeg. Consulte os requisitos.
Video Pin with Thumbnail
Informações adicionais sobre publicar Pins usando a API. Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro isVideo. Consulte o endpoint /post para detalhes.