Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/getAllgemeine Kategorietaxonomie durchsuchen

Allgemeine Kategorietaxonomie durchsuchen

Durchsucht die allgemeine Geschäftskategorie-Taxonomie (entspricht der von Google, Tausende Einträge) — globale Referenzdaten, nicht auf Ihre Agentur beschränkt. Die zurückgegebene ID ist eine Category-ID, die beim Erstellen oder Aktualisieren als categoryId eines Standorts gesetzt wird. Für den eigenen Katalog eines bestimmten Publishers verwenden Sie stattdessen GET /api/v1/locations/publisher-categories. Suche ganz weglassen, um die vollständige, unbegrenzte Taxonomie aufzulisten.

get/api/v1/locations/categories
locations:read
Query-Parameter
searchstringoptional
Zu suchender Kategoriename-Teilstring. Weglassen, um die gesamte Taxonomie unbegrenzt aufzulisten (limit wird in diesem Fall ignoriert).
limitintegeroptional
Zurückzugebende Zeilen, 1–100. Standardmäßig 25.
Antwort
dataobjectoptional
categoriesarray of objectoptional
Die passenden allgemeinen Kategorien.
idstringoptional
Die Category-ID — übergeben Sie diese als categoryId bei create oder update.
namestringoptional
Der Anzeigename der Kategorie.
Fehler
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/locations/categories
Ihr API-Schlüssel
search
limit
{
  "data": {
    "categories": [
      {
        "id": "cat_dentist",
        "name": "Dentist"
      },
      {
        "id": "cat_orthodontist",
        "name": "Orthodontist"
      }
    ]
  }
}