v1Recursos/Posts/postActualizar campos de publicaciones
Actualizar campos de publicaciones
Crea, renombra o archiva un campo personalizado de las publicaciones e ideas de publicación de un cliente, o establece valores en ellas. Envíe clientId, un mutationId y un command.
post
posts:write/api/v1/posts/fieldsCuerpo de la solicitud
clientIdstringobligatorio
ID del cliente cuyo conjunto de campos está modificando.
mutationIdstringobligatorio
Un UUID que usted elige para este cambio. Reenviarlo con el mismo command devuelve el primer resultado sin volver a aplicar el cambio; reutilizarlo con un command distinto devuelve 409.
commandobjectobligatorio
Un cambio. field_create añade un campo con label, type y options. field_update renombra un campo, cambia sus opciones o lo archiva o restaura, y requiere la versión actual del campo como expectedVersion. values_update establece de 1 a 1000 valores, cada uno con recordId, fieldId, value y expectedVersion, y aplica todos o ninguno. Una opción que los registros todavía tienen no se puede eliminar; archívela en su lugar. Un conjunto de campos admite como máximo 40 campos, incluidos los archivados.
Respuesta
dataobjectopcional
resultobjectopcional
Lo que hizo el cambio: el id del campo para field_create y field_update, o el número de valores escritos para values_update.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
413El cuerpo de la solicitud supera 1 MB.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503El servicio no está disponible temporalmente. Siga las indicaciones de reintento para esta operación.
post/api/v1/posts/fields
Su clave de API
Cuerpo de la solicitud*
{}Guías que usan este recurso
- 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 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 Publish Google Business Profile Posts ProgrammaticallyPublish announcements, offers and events to Google Business Profile via API, schedule them, handle the missing-connection draft, and measure post performance.
- 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.
- Publish a Google Business Profile Post via APIPublish an announcement, offer or event to a location's connected platforms, and handle the draft returned when a platform is not connected.