メインコンテンツへスキップ

Pinterest に画像 Pin を投稿する

Pinterest API では投稿に画像を含める必要があります。その他のパラメーターはオプションです。 詳細については Pinterest Media GuidelinesPinterest Authorization を参照してください。
Pinterest Post

Pinterest オプション

pinterestOptions パラメーターを使用して、投稿に追加のオプションを設定できます。
Pinterest Post
Pinterest オプションは、投稿を制御するために使用できるオプションフィールドです。
altText
array of strings
アクセシビリティとスクリーンリーダー用の画像と動画の代替テキスト。最大 500 文字。詳細については Pinterest Alternative Text を参照してください。
boardId
string
/user/details エンドポイントから ID を指定することで、ユーザーの別の Pinterest ボードに投稿します。指定されていない場合、デフォルトで連携されているボードに投稿します。詳細については Pinterest Board ID を参照してください。
オプションのタイトル、リンク、説明とともに最大 5 個の画像を Pinterest カルーセルとして追加します。各オブジェクトには titlelinkdescription を含めることができます。詳細については Pinterest Image Carousel を参照してください。
ユーザーが Pin 画像をクリックしたときに誘導される宛先 URL。最大 2048 文字。Pin にクリック可能なリンクを付与します。詳細については Pin Link を参照してください。
note
string
自分とボードコラボレーターだけが見ることができるプライベートなノートを個別の Pin に追加します。最大 1000 文字。詳細については Pin Note を参照してください。
thumbNail
string
動画 Pin のサムネイルを設定します。PNG または JPG、動画と同じ寸法、10MB 未満である必要があります。動画 Pin では必須です。詳細については Video Pin (Thumbnail) を参照してください。
title
string
“Add your title” セクションに表示する Pin のタイトル。最大 100 文字。詳細については Pin Title を参照してください。
*post フィールドのリンクはクリックできません。Pin にクリック可能なリンクを追加するには、link フィールドを使用してください。 詳細については Pinterest Media Guidelines を参照してください。

代替テキスト

Pinterest の画像または動画に代替テキスト(alt text とも呼ばれる)を追加します。Pinterest の alt text は、追加のユーザー情報とスクリーンリーダーに使用されるアクセシビリティ機能です。 pinterestOptions オブジェクトの altText を使用します。
Pinterest Alt Text
alt text は 500 文字に制限されています。

Board ID

/user/details エンドポイントから取得した ID を指定することで、ユーザーの別の Pinterest ボードに投稿します。それ以外の場合、デフォルトで連携されているボードに投稿します。 pinterestOptions オブジェクトの boardId を使用します。
Pinterest Board ID

文字数制限

詳細については Pinterest Character Limits を参照してください。

Pin リンク

ユーザーがピン画像をクリックしたときに誘導される宛先 URL。Pin にクリック可能なリンクを付与します。最大長は 2048 文字です。 pinterestOptions オブジェクトの link を使用します。
Pin Link

Pin ノート

ボード上の個別の Pin にプライベートなノートを追加できます。自分とボードコラボレーターだけが見ることができます。 pinterestOptions オブジェクトの note を使用します。
Pin Note

Pinterest 画像カルーセル

最大 5 個の画像を Pinterest カルーセルとして投稿します。複数のメディア URL を追加することで、自動的にカルーセルが作成されます。オプションのカルーセルパラメーターも追加できます。詳細は下記を参照してください。
Pinterest Carousel Post
オプションの carouselOptions フィールドは、オブジェクトの配列を受け取ります。各カルーセルオブジェクトは、対応するメディア URL 文字列に対応します。たとえば、最初のカルーセルオブジェクトは最初の mediaUrl 文字列を参照します。
  • title: 画像のタイトル。
  • link: 画像の外部宛先リンク。
  • description: 画像の説明。

Pinterest メンション

Pinterest 投稿に @handle を追加できますが、Pinterest は投稿テキスト内のメンション解決をサポートしていません。 @handle はプレーンテキストのままになります。

Pin タイトル

表示する Pin のタイトル。新しい Pin の “Add your title” セクションに表示されます。最大 100 文字。 pinterestOptions オブジェクトの title を使用します。
Pin Title

動画 Pin(サムネイル)

動画は /post エンドポイント の標準の mediaUrls フィールドを使用して Pin として投稿できます。加えて、image/jpeg などの有効なメディア Content-Type を持つサムネイル画像 URL を必ず含める必要があります要件 を参照してください。
Video Pin with Thumbnail
API を使用した Pin の投稿 についての追加情報。 動画が mp4 などの既知の動画拡張子で終わらない場合は、isVideo パラメーターを使用してください。詳細は /post エンドポイント を参照してください。