Pular para o conteúdo principal

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.
altText
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.
boardId
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.
note
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.
thumbNail
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.
title
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.

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

Carrossel de imagens do Pinterest

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.