v1Ressources/Clients/patchModifier un ensemble d’annuaires
Modifier un ensemble d’annuaires
Les propriétaires et administrateurs ayant accès aux Clients gèrent les ensembles. Les membres disposant d’un accès à toute l’agence peuvent lister les choix et attribuer des ensembles aux clients accessibles. Les identifiants limités à des clients sont refusés. Des siteIds vides excluent tous les annuaires ; les ensembles ne peuvent pas élargir les droits de l’agence. Les modifications exigent la révision actuelle et au moins un champ modifié. Un ensemble attribué ne peut pas être supprimé. L’attribution est atomique et planifie les ajustements des fiches en arrière-plan.
patch
clients:write/api/v1/publisher-sets/{id}Paramètres de requête
idstringobligatoire
ID de l’ensemble.
Corps de la requête
namestringfacultatif
Nom unique de 100 caractères maximum.
siteIdsarray of integerfacultatif
Sélection complète des IDs d’annuaires. Un tableau vide exclut tous les annuaires.
revisionintegerobligatoire
Révision actuelle renvoyée par une lecture. Les révisions périmées sont refusées.
Réponse
dataobjectfacultatif
publisherSetobjectfacultatif
idstringfacultatif
namestringfacultatif
Nom unique de 100 caractères maximum.
siteIdsarray of integerfacultatif
Sélection complète des IDs d’annuaires. Un tableau vide exclut tous les annuaires.
revisionintegerfacultatif
Révision actuelle renvoyée par une lecture. Les révisions périmées sont refusées.
createdAtstringfacultatif
updatedAtstringfacultatif
clientCountintegerfacultatif
adjustmentstringfacultatif
affectedClientsintegerfacultatif
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409Le nom est pris, la révision est périmée ou l’ensemble est encore attribué.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
patch/api/v1/publisher-sets/{id}
Votre clé API
id *
Corps de la requête*
{}Guides qui utilisent cette ressource
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- 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 a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.
- 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.