Pinterest に画像 Pin を投稿する
Pinterest API では投稿に画像を含める必要があります。その他のパラメーターはオプションです。 詳細については Pinterest Media Guidelines と Pinterest Authorization を参照してください。Pinterest Post
Pinterest オプション
pinterestOptions パラメーターを使用して、投稿に追加のオプションを設定できます。
Pinterest Post
アクセシビリティとスクリーンリーダー用の画像と動画の代替テキスト。最大 500 文字。詳細については Pinterest Alternative Text を参照してください。
/user/details エンドポイントから ID を指定することで、ユーザーの別の Pinterest ボードに投稿します。指定されていない場合、デフォルトで連携されているボードに投稿します。詳細については Pinterest Board ID を参照してください。
オプションのタイトル、リンク、説明とともに最大 5 個の画像を Pinterest カルーセルとして追加します。各オブジェクトには
title、link、description を含めることができます。詳細については Pinterest Image Carousel を参照してください。動画 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
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 エンドポイント を参照してください。