Skip to main content

Pinterest に画像 Pin を投稿する

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

Pinterest オプション

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

Pinterest AI 開示

Pin の作成時に Pinterest の AI 開示宣言を送信するには、pinterestOptions.aiDisclosures を使用します。開示は画像カルーセルを含む Pin 全体に適用され、画像 Pin、カルーセル Pin、動画 Pin でサポートされています。
Pinterest AI Disclosure
指定できる 2 つの値を同時に送信することもできます:
Pinterest AI Disclosure
指定できる値:
  • AI_MODIFIED: Pin に AI によって加工されたコンテンツが含まれています。
  • SYNTHETIC_PERFORMER: Pin に合成された出演者(シンセティックパフォーマー)が含まれています。
aiDisclosures が省略されているか空の配列の場合、Ayrshare は Pinterest に AI 開示フィールドを送信しません。重複した値は 1 回だけ送信されます。値は大文字と小文字が区別され、変換されることはありません。 オプションが無効な場合(たとえば不明な値、大文字・小文字の誤り、配列以外の値、文字列以外の要素を含む配列など)でも Pin は正常に公開される可能性がありますが、Ayrshare は開示オプション全体を省略し、Pinterest の結果に致命的でない警告を返します。Pin に明示的な AI 開示が必要な場合は、リクエストを修正し、指定できる値のいずれかまたは両方を送信してください。なお、Pinterest が独自にラベルを付与する場合もあります。 MCP サーバーと GraphQL API では、最初に値の型がチェックされます。これらのインターフェースでは、数値を含むリストなどの不正な形式の値は、警告付きで公開されるのではなく、投稿前に拒否されます。不明な文字列や大文字・小文字が誤っている文字列は、引き続き警告付きで公開されます。

Board ID

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

文字数制限

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

Pin ノート

ボード上の個別の Pin にプライベートなノートを追加できます。自分とボードコラボレーターだけが見ることができます。 pinterestOptions オブジェクトの note を使用します。
Pin Note
最大 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 エンドポイント を参照してください。