Tag

Ein Tag ist eine kurze Bezeichnung, mit der sich Content oder Media kategorisieren lassen. Am Beispiel eines Online-Bekleidungsshops sind Bezeichnungen wie "Bestseller" oder "Neuheiten" Tags. Wenn Sie denselben Tag an mehrere Content- oder Media-Elemente anhängen, können Sie diese später anhand dieser Bezeichnung gebündelt abfragen oder auswählen.

Ein Tag selbst ist eine Bezeichnung, die nur einen Namen (name) besitzt, und eine Konfigurationsressource ohne Veröffentlichungskonzept. Das eigentliche Anhängen an etwas erfolgt nicht durch direktes Bearbeiten des Tags, sondern indem Sie den Refer dieses Tags in das metadata.tags eines Content- oder Media-Elements eintragen (siehe Tags an Content und Media anhängen weiter unten). In der CMA ist ein Tag eine untergeordnete Ressource eines Space, und der Pfad richtet sich nach /spaces/{spaceId}/tags.

Ressourcenstruktur

Im Folgenden sehen Sie die Antwort der Einzelabfrage des Tags "Bestseller". Er besitzt sys (Systemeigenschaften) und die inhaltliche Eigenschaft name.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh",
    "type": "Tag",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-16T01:46:07.426Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-16T01:46:07.426Z",
    "version": 1
  },
  "name": "Bestseller"
}

Wichtige Schlüssel:

• sys.id: Eindeutiger Bezeichner des Tags. Er wird in {tagId} der Pfade für Einzelabfrage, Bearbeitung und Löschung eingesetzt und dient beim Anhängen eines Tags über metadata.tags zugleich als Ziel-id des Refer.
• name: Name des Tags (1 bis 16 Zeichen). Es ist die Bezeichnung selbst, die bei der Inhaltsklassifizierung sichtbar ist.

Systemeigenschaften (sys)

Jeder Tag führt die gemeinsamen Systemeigenschaften im Objekt sys. space, createdBy und updatedBy werden in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) eingetragen.

Inhaltliche Eigenschaften:

Ein Tag ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Anders als Content und Media hat sys daher kein publish, archive oder status, sondern nur version. version erhöht sich bei jeder Bearbeitung des Tags.

Tags an Content und Media anhängen

Um einen Tag anzuhängen, durchlaufen Sie zwei Schritte.

1. Erstellen Sie einen Tag (Endpunkt Tag erstellen weiter unten). Bewahren Sie die sys.id aus der Antwort auf.
2. Tragen Sie beim Erstellen oder Bearbeiten eines Content- oder Media-Elements den Refer dieses Tags in das Array metadata.tags von dessen Inhalt ein.

Der Refer, der in metadata.tags eingetragen wird, hat folgende Form. In id setzen Sie die sys.id des in Schritt 1 erhaltenen Tags ein.

"metadata": {
  "tags": [
    { "sys": { "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh", "type": "Refer", "targetType": "Tag" } }
  ]
}

Um mehrere Tags anzuhängen, tragen Sie mehrere dieser Refer-Objekte in das Array ein. Um einen Tag zu entfernen, nehmen Sie den entsprechenden Eintrag aus dem Array heraus und bearbeiten das Content- oder Media-Element erneut. Eine ausführliche Beschreibung, wie die Inhaltsdaten von Content und Media aufgebaut werden, finden Sie in den Dokumenten Content und Media.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Header Authorization ist ein Bearer-Token erforderlich, das sich bei der CMA authentifiziert. Bei Bearbeitung und Teilbearbeitung müssen Sie zur optimistischen Nebenläufigkeitskontrolle zusätzlich den Header X-Weegloo-Version (die sys.version der aktuellen Ressource) senden. Bei Erstellung und Löschung entfällt dieser Header.

Verwandte Dokumente

• Content: Inhaltsdaten, an die über metadata.tags Tags angehängt werden.
• Media: Dateiressource, an die über metadata.tags Tags angehängt werden.