Skip to main content

Einen Bild-Pin auf Pinterest posten

Die Pinterest API erfordert, dass im Beitrag ein Bild enthalten ist. Andere Parameter sind optional. Weitere Informationen finden Sie unter Pinterest-Medienrichtlinien und Pinterest-Autorisierung.
Pinterest Post

Pinterest-Optionen

Sie können zusätzliche Optionen für einen Beitrag über den Parameter pinterestOptions festlegen.
Pinterest Post
Pinterest-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt.
array of strings
Der Alternativtext für Bilder und Videos zur Barrierefreiheit und für Screenreader. Maximal 500 Zeichen.Weitere Informationen finden Sie unter Pinterest-Alternativtext.
array of strings
Deklarieren Sie AI-Offenlegungen für den gesamten Pin. Akzeptierte Werte sind AI_MODIFIED und SYNTHETIC_PERFORMER.Weitere Informationen finden Sie unter Pinterest-AI-Offenlegungen.
string
Posten Sie auf einem anderen Pinterest-Board des Nutzers, indem Sie die ID aus dem Endpunkt /user/details angeben.Wenn nicht angegeben, wird auf dem standardmäßig verknüpften Board gepostet.Weitere Informationen finden Sie unter Pinterest-Board-ID.
Fügen Sie bis zu 5 Bilder als Pinterest-Karussell mit optionalen Titeln, Links und Beschreibungen hinzu.Jedes Objekt kann Folgendes enthalten: title, link und description.Weitere Informationen finden Sie unter Pinterest-Bilder-Karussell.
Die Ziel-URL, zu der Nutzer beim Klicken auf das Pin-Bild geleitet werden. Maximal 2048 Zeichen.Erstellt einen anklickbaren Link, der Ihrem Pin zugeordnet ist.Weitere Informationen finden Sie unter Pin-Link.
string
Fügen Sie einzelnen Pins private Notizen hinzu, die nur Sie und Board-Mitarbeitende sehen. Maximal 1000 Zeichen.Weitere Informationen finden Sie unter Pin-Notiz.
string
Legen Sie ein Thumbnail für Video-Pins fest. Muss PNG oder JPG sein, die gleichen Abmessungen wie das Video haben und unter 10 MB liegen.Für Video-Pins erforderlich.Weitere Informationen finden Sie unter Video-Pin (Thumbnail).
string
Der Titel des Pins, der im Abschnitt „Add your title” angezeigt wird. Maximal 100 Zeichen.Weitere Informationen finden Sie unter Pin-Titel.
*Links im Feld post sind nicht anklickbar. Verwenden Sie das Feld link, um einen anklickbaren Link zum Pin hinzuzufügen. Weitere Informationen finden Sie unter Pinterest-Medienrichtlinien.

Alternativtext

Fügen Sie einem Pinterest-Bild oder -Video einen Alternativtext (Alt-Text) hinzu. Pinterest-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader. Verwenden Sie altText im Objekt pinterestOptions.
Pinterest Alt Text
Der Alt-Text ist auf 500 Zeichen begrenzt.

Pinterest-AI-Offenlegungen

Verwenden Sie pinterestOptions.aiDisclosures, um beim Erstellen eines Pins die AI-Offenlegungserklärungen von Pinterest zu senden. Die Offenlegungen gelten für den gesamten Pin, einschließlich Bildkarussells, und werden für Bild-Pins, Karussell-Pins und Video-Pins unterstützt.
Pinterest AI Disclosure
Sie können beide akzeptierten Werte zusammen senden:
Pinterest AI Disclosure
Akzeptierte Werte:
  • AI_MODIFIED: Der Pin enthält durch AI veränderte Inhalte.
  • SYNTHETIC_PERFORMER: Der Pin enthält einen synthetischen Darsteller.
Wenn aiDisclosures weggelassen wird oder ein leeres Array ist, sendet Ayrshare kein AI-Offenlegungsfeld an Pinterest. Doppelte Werte werden nur einmal gesendet. Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden, und sie werden nicht umgewandelt. Wenn die Option ungültig ist, zum Beispiel bei einem unbekannten Wert, falscher Groß-/Kleinschreibung, einem Wert, der kein Array ist, oder einem Array mit einem Eintrag, der kein String ist, kann der Pin trotzdem erfolgreich veröffentlicht werden, aber Ayrshare lässt die gesamte Offenlegungsoption weg und gibt im Pinterest-Ergebnis eine nicht fatale Warnung zurück. Korrigieren Sie die Anfrage und senden Sie einen oder beide akzeptierten Werte, wenn der Pin eine explizite AI-Offenlegung benötigt. Pinterest kann unabhängig davon weiterhin eigene Labels anwenden. Der MCP-Server und die GraphQL API prüfen zuerst die Werttypen. Bei diesen Schnittstellen wird ein fehlerhafter Wert, etwa eine Liste mit einer Zahl, vor dem Veröffentlichen abgelehnt, statt mit einer Warnung veröffentlicht zu werden. Unbekannte Strings oder Strings mit falscher Groß-/Kleinschreibung werden weiterhin mit der Warnung veröffentlicht.

Board-ID

Posten Sie auf einem anderen Pinterest-Board des Nutzers, indem Sie die vom Endpunkt /user/details erhaltene ID angeben. Andernfalls wird auf dem standardmäßig verknüpften Board gepostet. Verwenden Sie boardId im Objekt pinterestOptions.
Pinterest Board ID

Zeichenbeschränkungen

Weitere Informationen finden Sie unter Pinterest-Zeichenbeschränkungen. Die Ziel-URL, zu der Nutzer beim Klicken auf Ihr Pin-Bild geleitet werden. Dadurch entsteht ein anklickbarer Link, der Ihrem Pin zugeordnet ist. Die maximale Länge beträgt 2048 Zeichen. Verwenden Sie link im Objekt pinterestOptions.
Pin Link

Pin-Notiz

Sie können einzelnen Pins auf Ihren Boards private Notizen hinzufügen. Nur Sie und Board-Mitarbeitende können sie sehen. Verwenden Sie note im Objekt pinterestOptions.
Pin Note
Posten Sie bis zu fünf Bilder als Pinterest-Karussell. Wenn Sie mehr als eine Medien-URL angeben, wird automatisch ein Karussell erstellt. Sie können außerdem optionale Karussell-Parameter hinzufügen. Siehe unten.
Pinterest Carousel Post
Das optionale Feld carouselOptions erwartet ein Array von Objekten. Jedes Karussell-Objekt entspricht dem jeweiligen Media-URL-String, z. B. bezieht sich das erste Karussell-Objekt auf den ersten mediaUrl-String.
  • title: Der Bildtitel.
  • link: Der externe Ziel-Link für das Bild.
  • description: Die Bildbeschreibung.

Pinterest-Erwähnungen

Sie können zwar ein @handle zu einem Pinterest-Beitrag hinzufügen, Pinterest unterstützt aber keine Auflösung von Erwähnungen im Beitragstext. Das @handle bleibt als reiner Text bestehen.

Pin-Titel

Der Titel des Pins, der angezeigt wird. Er erscheint im Abschnitt „Add your title” eines neuen Pins. Maximal 100 Zeichen. Verwenden Sie title im Objekt pinterestOptions.
Pin Title

Video-Pin (Thumbnail)

Ein Video kann als Pin über das Standardfeld mediaUrls im /post-Endpunkt veröffentlicht werden. Zusätzlich muss eine Thumbnail-Bild-URL mit dem Video übergeben werden, die einen gültigen Media-Content-Type wie image/jpeg hat. Siehe Anforderungen.
Video Pin with Thumbnail
Zusätzliche Informationen zum Posten von Pins über die API. Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter isVideo. Weitere Informationen finden Sie unter /post-Endpunkt.