Synupv1
Schlüssel erstellen
v1Ressourcen/Media/patchAsset aktualisieren

Asset aktualisieren

Aktualisiert die Overlay-Metadaten eines Assets — Tags, Ordnerzugehörigkeit, zugewiesene Standorte — und, nur bei Uploads, seinen Titel. Synchronisierte/generierte Quellen ignorieren den Titel; dort ist er schreibgeschützt.

patch/api/v1/media/{id}
media:write
Query-Parameter
idstringerforderlich
Das zu aktualisierende Asset.
Anfragetext
titlestringoptional
Neuer Titel. Nur bei Uploads; wird bei anderen Quellen ignoriert.
tagsarray of stringoptional
Ersetzt die vollständige Tag-Liste des Assets, nach Name.
folderIdsarray of stringoptional
Ersetzt die Ordnerzugehörigkeit des Assets.
locationIdsarray of stringoptional
Ersetzt die zugewiesenen Standorte des Assets.
statusstring (ok | needs_review | spam)optional
Setzt das Moderationsurteil manuell. Nur bei synchronisierten Medien.
statusReasonstringoptional
Optionale Notiz zur Begründung des Status, die daneben angezeigt wird.
Antwort
dataobjectoptional
assetobjectoptional
keystringoptional
Zusammengesetzte Kennung für das Asset, im Format „<source>:<id>“.
sourcestringoptional
Herkunft dieses Assets (z. B. ein OS-Upload gegenüber einer importierten Quelle).
idstringoptional
Die ID des Assets innerhalb seiner Quelle.
titlestringoptional
Der Titel des Assets.
filenamestringoptional
Der ursprüngliche Dateiname des Assets.
mimestringoptional
Der MIME-Typ des Assets.
kindstringoptional
Die Art des Assets (Foto oder Video).
sizeBytesnumberoptional
Dateigröße in Bytes, oder null, wenn unbekannt.
urlstringoptional
Sofort nutzbare URL für die Bytes des Assets.
thumbnailUrlstringoptional
URL einer Vorschau-Miniaturansicht, oder null.
tagsarray of stringoptional
Dem Asset zugeordnete Tags.
folderIdsarray of stringoptional
Asset-Ordner, zu denen dieses Asset gehört.
locationIdsarray of stringoptional
Jeder Standort, dem dieses Asset zugeordnet ist.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/media/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "asset": {
      "key": "upload:abc123",
      "source": "upload",
      "id": "abc123",
      "title": "Storefront photo",
      "filename": "storefront.jpg",
      "mime": "image/jpeg",
      "kind": "image",
      "sizeBytes": 482913,
      "url": "https://cdn.synup.com/media/abc123.jpg",
      "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
      "tags": [
        "VIP"
      ],
      "folderIds": [
        "folder_1"
      ],
      "locationIds": [
        "loc_456"
      ]
    }
  }
}