GBP Format Requirement

Synoveo API accepts Google Business Profile API v1 format only.

Why GBP Format?

• No proprietary models - Learn GBP format once
• Direct mapping - Easy migration from Google API
• Consistency - Same format Google uses
• Simplicity - Your platform transforms, we forward

Contract

Your application:

1. Extracts data from your platform
2. Transforms to GBP format
3. Sends to Synoveo API

Synoveo:

1. Validates the data
2. Filters fields by plan
3. Applies rate limits
4. Forwards to Google

Example

Location Update

{
  "title": "My Business Name",
  "storefrontAddress": {
    "addressLines": ["123 Main St"],
    "locality": "San Francisco",
    "administrativeArea": "CA",
    "postalCode": "94102",
    "regionCode": "US"
  },
  "phoneNumbers": {
    "primaryPhone": "+1 555-123-4567"
  },
  "regularHours": {
    "periods": [
      {
        "openDay": "MONDAY",
        "openTime": { "hours": 9 },
        "closeDay": "MONDAY",
        "closeTime": { "hours": 17 }
      }
    ]
  }
}

Reference

• Google Business Profile API v1
• Field types and formats follow Google's specification

Field Filtering

Synoveo filters fields based on your plan:

• Fields not in your plan are stripped
• No error, just filtered out
• Upgrade to access more fields