Pinterest に画像 Pin を投稿する
Pinterest API では投稿に画像を含める必要があります。その他のパラメーターはオプションです。 詳細については Pinterest Media Guidelines と Pinterest Authorization を参照してください。Pinterest Post
Pinterest オプション
pinterestOptions パラメーターを使用して、投稿に追加のオプションを設定できます。
Pinterest Post
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 を参照してください。
array of objects
オプションのタイトル、リンク、説明とともに最大 5 個の画像を Pinterest カルーセルとして追加します。各オブジェクトには
title、link、description を含めることができます。詳細については Pinterest Image Carousel を参照してください。string
string
動画 Pin のサムネイルを設定します。PNG または JPG、動画と同じ寸法、10MB 未満である必要があります。動画 Pin では必須です。詳細については Video Pin (Thumbnail) を参照してください。
post フィールドのリンクはクリックできません。Pin にクリック可能なリンクを追加するには、link フィールドを使用してください。
詳細については Pinterest Media Guidelines を参照してください。
代替テキスト
Pinterest の画像または動画に代替テキスト(alt text とも呼ばれる)を追加します。Pinterest の alt text は、追加のユーザー情報とスクリーンリーダーに使用されるアクセシビリティ機能です。pinterestOptions オブジェクトの altText を使用します。
Pinterest Alt Text
Pinterest AI 開示
Pin の作成時に Pinterest の AI 開示宣言を送信するには、pinterestOptions.aiDisclosures を使用します。開示は画像カルーセルを含む Pin 全体に適用され、画像 Pin、カルーセル Pin、動画 Pin でサポートされています。
Pinterest AI Disclosure
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 を参照してください。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
isVideo パラメーターを使用してください。詳細は /post エンドポイント を参照してください。