v1Recursos/Reviews/patchCompartilhar ou deixar de compartilhar uma nota de avaliação
Compartilhar ou deixar de compartilhar uma nota de avaliação
Define se uma das notas da sua agência sobre uma avaliação é compartilhada com o cliente no portal do cliente (shared) ou fica restrita à agência (internal). Só a visibilidade muda; o texto da nota permanece como foi escrito. Uma nota escrita pelo cliente é sempre compartilhada e não pode ser alterada (403), e uma nota que não pertence a esta avaliação retorna 404. Um token limitado a clientes específicos só pode alterar notas de avaliações desses clientes.
patch
reviews:write/api/v1/reviews/notesCorpo da solicitação
reviewIdstringobrigatório
A avaliação à qual a nota pertence.
noteIdstringobrigatório
A nota a ser alterada.
visibilitystring (internal | shared)obrigatório
shared para mostrar a nota ao cliente no portal do cliente, ou internal para mantê-la restrita à agência.
Resposta
dataobjectopcional
updatedbooleanopcional
visibilitystring (internal | shared)opcional
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
patch/api/v1/reviews/notes
Sua chave de API
Corpo da solicitação*
{}Guias que usam este recurso
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Build an AI Agent That Responds to ReviewsBuild an AI agent that drafts and posts review replies, with rating-based guardrails, human approval for negatives, and protection against injection.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Fetch and Respond to Reviews via APIFetch reviews from Google, Facebook and custom review sites, filter them, post owner replies, add internal notes and read review analytics with the Synup API.
- How to Build Automated Review-Response WorkflowsBuild a review-response workflow that routes reviews by rating and sentiment, drafts replies, approves them, and pushes them back to the platform.
- Fetch Recent Reviews via APIPull a location's reviews from every connected platform with the Synup API, filter to what needs attention, and page through with a cursor.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Respond to a Review via APIPost an owner reply to a review with the Synup API, read the push status back, and know which failures are worth a retry.