Update location details

curl --request PUT \
  --url https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "updateMask": "regularHours,specialHours"
}
'

import requests

url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details"

payload = { "updateMask": "regularHours,specialHours" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({updateMask: 'regularHours,specialHours'})
};

fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'updateMask' => 'regularHours,specialHours'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details"

	payload := strings.NewReader("{\n  \"updateMask\": \"regularHours,specialHours\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updateMask\": \"regularHours,specialHours\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updateMask\": \"regularHours,specialHours\"\n}"

response = http.request(request)
puts response.read_body

{
  "accountId": "<string>",
  "locationId": "<string>",
  "success": true
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

AIsa Social

Update location details

Google Business. Acts in public on your connected account; needs social:publish. Audited. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Updates Google Business Profile location details. The updateMask field is required and specifies which fields to update. This endpoint proxies Google's Business Information API locations.patch, so any valid updateMask field is supported. Common fields: regularHours, specialHours, profile.description, websiteUri, phoneNumbers, categories, serviceItems.  A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

PUT

https://api.aisa.one

apis

social

accounts

{accountId}

gmb-location-details

Update location details

curl --request PUT \
  --url https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "updateMask": "regularHours,specialHours"
}
'

import requests

url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details"

payload = { "updateMask": "regularHours,specialHours" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({updateMask: 'regularHours,specialHours'})
};

fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'updateMask' => 'regularHours,specialHours'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details"

	payload := strings.NewReader("{\n  \"updateMask\": \"regularHours,specialHours\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updateMask\": \"regularHours,specialHours\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updateMask\": \"regularHours,specialHours\"\n}"

response = http.request(request)
puts response.read_body

{
  "accountId": "<string>",
  "locationId": "<string>",
  "success": true
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

Request contract

Method and path: PUT /apis/v1/social/accounts/{accountId}/gmb-location-details
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details
accountId: path; required
locationId: query; optional
Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "put_aisa_social_apis_v1_social_accounts_accountid_7d035a",
  "method": "PUT",
  "path": "/apis/v1/social/accounts/{accountId}/gmb-location-details",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "One of your social accounts (acc_...).",
      "in": "path",
      "name": "accountId",
      "required": true,
      "schema": {
        "pattern": "^acc_[0-9A-Za-z]{22}$",
        "type": "string"
      }
    },
    {
      "description": "Override which location to target. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.",
      "in": "query",
      "name": "locationId",
      "required": false,
      "schema": {
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "regularHours": {
            "periods": [
              {
                "closeDay": "MONDAY",
                "closeTime": "17:00",
                "openDay": "MONDAY",
                "openTime": "09:00"
              },
              {
                "closeDay": "SATURDAY",
                "closeTime": "14:00",
                "openDay": "SATURDAY",
                "openTime": "10:00"
              }
            ]
          },
          "specialHours": {
            "specialHourPeriods": [
              {
                "closed": true,
                "startDate": {
                  "day": 25,
                  "month": 12,
                  "year": 2026
                }
              },
              {
                "closeTime": "15:00",
                "openTime": "09:00",
                "startDate": {
                  "day": 31,
                  "month": 12,
                  "year": 2026
                }
              }
            ]
          },
          "updateMask": "regularHours,specialHours"
        },
        "schema": {
          "additionalProperties": true,
          "properties": {
            "adWordsLocationExtensions": {
              "description": "Alternate phone shown in Google Ads location extensions. Use updateMask='adWordsLocationExtensions'.",
              "properties": {
                "adPhone": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "categories": {
              "description": "Primary and additional business categories. Use updateMask='categories' to update.",
              "properties": {
                "additionalCategories": {
                  "items": {
                    "properties": {
                      "name": {
                        "description": "Category resource name (e.g. 'categories/gcid:dry_cleaner')",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                },
                "primaryCategory": {
                  "properties": {
                    "name": {
                      "description": "Category resource name (e.g. 'categories/gcid:laundromat'). Use Google's Categories API to look up valid IDs.",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              },
              "type": "object"
            },
            "labels": {
              "description": "Free-form, internal-only labels for grouping (1-255 characters each). Use updateMask='labels'.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "latlng": {
              "description": "Precise coordinates. Use updateMask='latlng'. Google restricts latlng writes to approved clients, so this update may be silently ignored or rejected.",
              "properties": {
                "latitude": {
                  "type": "number"
                },
                "longitude": {
                  "type": "number"
                }
              },
              "type": "object"
            },
            "moreHours": {
              "description": "Additional hours for specific services (delivery, drive-through, etc.). Use updateMask='moreHours'.",
              "items": {
                "properties": {
                  "hoursTypeId": {
                    "description": "Hours type from Google's catalog (e.g. 'DELIVERY', 'DRIVE_THROUGH')",
                    "type": "string"
                  },
                  "periods": {
                    "items": {
                      "properties": {
                        "closeDay": {
                          "type": "string"
                        },
                        "closeTime": {
                          "type": "string"
                        },
                        "openDay": {
                          "type": "string"
                        },
                        "openTime": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "openInfo": {
              "description": "Open/closed status of the location. Use updateMask='openInfo'.",
              "properties": {
                "openingDate": {
                  "properties": {
                    "day": {
                      "type": "integer"
                    },
                    "month": {
                      "type": "integer"
                    },
                    "year": {
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "status": {
                  "enum": [
                    "OPEN",
                    "CLOSED_PERMANENTLY",
                    "CLOSED_TEMPORARILY"
                  ],
                  "type": "string"
                }
              },
              "type": "object"
            },
            "phoneNumbers": {
              "properties": {
                "additionalPhones": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "primaryPhone": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "profile": {
              "properties": {
                "description": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "regularHours": {
              "properties": {
                "periods": {
                  "items": {
                    "properties": {
                      "closeDay": {
                        "type": "string"
                      },
                      "closeTime": {
                        "type": "string"
                      },
                      "openDay": {
                        "type": "string"
                      },
                      "openTime": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "serviceArea": {
              "description": "Areas the business serves. Use updateMask='serviceArea'. Full replacement: send every place you want to keep.",
              "properties": {
                "businessType": {
                  "enum": [
                    "CUSTOMER_LOCATION_ONLY",
                    "CUSTOMER_AND_BUSINESS_LOCATION"
                  ],
                  "type": "string"
                },
                "places": {
                  "properties": {
                    "placeInfos": {
                      "items": {
                        "properties": {
                          "placeId": {
                            "description": "Google Place ID for the area",
                            "type": "string"
                          },
                          "placeName": {
                            "description": "Localized area name (e.g. 'Sao Paulo, SP, Brasil')",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                },
                "regionCode": {
                  "description": "Immutable. CLDR region code of the country the business is based in (e.g. 'BR')",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "serviceItems": {
              "description": "Services offered by the business. Use updateMask='serviceItems' to update.",
              "items": {
                "properties": {
                  "freeFormServiceItem": {
                    "description": "A custom service not in Google's catalog",
                    "properties": {
                      "category": {
                        "description": "Category resource name this service belongs to (e.g. 'categories/gcid:laundromat')",
                        "type": "string"
                      },
                      "label": {
                        "properties": {
                          "displayName": {
                            "description": "Service name as displayed to users",
                            "type": "string"
                          },
                          "languageCode": {
                            "description": "Language code (e.g. 'en')",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "type": "object"
                  },
                  "price": {
                    "description": "Optional price for the service",
                    "properties": {
                      "currencyCode": {
                        "description": "ISO 4217 currency code (e.g. 'USD')",
                        "type": "string"
                      },
                      "nanos": {
                        "description": "Nano units (10^-9) of the amount",
                        "type": "integer"
                      },
                      "units": {
                        "description": "Whole units of the amount",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "structuredServiceItem": {
                    "description": "A predefined service from Google's service type catalog",
                    "properties": {
                      "description": {
                        "description": "Optional description of the service",
                        "type": "string"
                      },
                      "serviceTypeId": {
                        "description": "Service type ID from Google's catalog (e.g. 'job_type_id:plumbing_drain_repair')",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "specialHours": {
              "properties": {
                "specialHourPeriods": {
                  "items": {
                    "properties": {
                      "closeTime": {
                        "type": "string"
                      },
                      "closed": {
                        "type": "boolean"
                      },
                      "endDate": {
                        "properties": {
                          "day": {
                            "type": "integer"
                          },
                          "month": {
                            "type": "integer"
                          },
                          "year": {
                            "type": "integer"
                          }
                        },
                        "type": "object"
                      },
                      "openTime": {
                        "type": "string"
                      },
                      "startDate": {
                        "properties": {
                          "day": {
                            "type": "integer"
                          },
                          "month": {
                            "type": "integer"
                          },
                          "year": {
                            "type": "integer"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "storeCode": {
              "description": "External store identifier, unique within the account. Use updateMask='storeCode'.",
              "type": "string"
            },
            "storefrontAddress": {
              "description": "Postal address of the storefront. Use updateMask='storefrontAddress'. Omit for service-area-only businesses.",
              "properties": {
                "addressLines": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "administrativeArea": {
                  "description": "State or province",
                  "type": "string"
                },
                "languageCode": {
                  "type": "string"
                },
                "locality": {
                  "description": "City",
                  "type": "string"
                },
                "postalCode": {
                  "type": "string"
                },
                "regionCode": {
                  "description": "ISO 3166-1 alpha-2 country code (e.g. 'BR')",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "title": {
              "description": "Business name. Use updateMask='title'.",
              "type": "string"
            },
            "updateMask": {
              "description": "Required. Comma-separated fields to update (e.g. 'regularHours', 'specialHours', 'profile.description', 'categories', 'serviceItems'). Any valid Google Business Information API updateMask field is supported.",
              "type": "string"
            },
            "websiteUri": {
              "type": "string"
            }
          },
          "required": [
            "updateMask"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "description": "Included with your connected social accounts: AIsa does not charge per call.",
    "kind": "no_customer_charge"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

accountId

string

required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

Query Parameters

locationId

string

Override which location to target. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.

Body

application/json

updateMask

string

required

Required. Comma-separated fields to update (e.g. 'regularHours', 'specialHours', 'profile.description', 'categories', 'serviceItems'). Any valid Google Business Information API updateMask field is supported.

adWordsLocationExtensions

object

Alternate phone shown in Google Ads location extensions. Use updateMask='adWordsLocationExtensions'.

Show child attributes

Response

Location updated successfully

accountId

string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

locationId

string

success

boolean

​Request contract

​Cost and request rules

Authorizations

Path Parameters

Query Parameters

Body

Response

Request contract

Cost and request rules