Synupv1
Schlüssel erstellen
v1Ressourcen/SEO/patchRaster-Konfiguration eines Standorts aktualisieren

Raster-Konfiguration eines Standorts aktualisieren

Aktualisiert die Raster-Messkonfiguration eines Standorts: Rastergröße, Abstand zwischen Punkten, ausgeschlossene Rasterpunkte oder ob Wasser-Rasterpunkte in die Statistik einfließen. Übergeben Sie nur die zu ändernden Felder. Wasserpunkte werden ohnehin immer abgefragt — includeWaterPoints steuert nur, ob sie gezählt und angezeigt werden. Die Lese-Seite wird bereits von GET /api/v1/seo/keywords abgedeckt, dessen Antwort includeWaterPoints bereits enthält.

patch/api/v1/seo/config
seo:write
Anfragetext
locationIdstringerforderlich
Der zu konfigurierende Standort.
clientIdstringoptional
Der Kunde des Standorts.
gridSizeinteger (3 | 5 | 7)optional
Rastergröße: 3, 5 oder 7.
distanceKmnumberoptional
Abstand in Kilometern zwischen benachbarten Rasterpunkten.
excludedarray of objectoptional
Von der Messung auszuschließende Rasterpunkte.
rowintegeroptional
Rasterzeilenindex, nullbasiert.
colintegeroptional
Rasterspaltenindex, nullbasiert.
includeWaterPointsbooleanoptional
Ob Wasser-Rasterpunkte in die Statistik einfließen.
Antwort
dataobjectoptional
configobjectoptional
Die Raster-Konfiguration des Standorts nach der Aktualisierung.
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/seo/config
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "config": {
      "id": "cm_cfg_abc123",
      "synupLocationId": "os_9f8e7d6c",
      "clientLocationId": "cm_loc_1",
      "agencyId": "cm_agency_1",
      "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
      "centerLat": 30.2672,
      "centerLng": -97.7431,
      "gridSize": 5,
      "distanceKm": 1.5,
      "excludedPoints": [
        {
          "row": 4,
          "col": 4
        }
      ],
      "generationStartedAt": null,
      "lastRunStatus": "complete",
      "lastError": null,
      "includeWaterPoints": true,
      "lastGeneratedAt": "2026-02-01T06:00:00.000Z",
      "createdAt": "2026-01-10T09:00:00.000Z",
      "updatedAt": "2026-02-05T10:00:00.000Z"
    }
  }
}