PluggzyDocs

Google Business Profile

PublicacionesEventos y ofertasProgramaciónMétricas
PublicacionesEventos y ofertasProgramaciónMétricas

Publica novedades, eventos y ofertas en tu Perfil de Empresa de Google desde cualquier app de IA, para que aparezcan en la Búsqueda y en Maps, al momento o a la hora que elijas.

Conexión con
tu inicio de sesión de Google, en tu navegador
Herramientas
6 herramientas de publicación compartidas
Bandeja de entrada
no disponible en Google Business Profile
10 / díapublicaciones, al momento o programadas
2–5 sentre acciones, al azar
1500caracteres de texto
1imagen por publicación

Límites

AcciónPor díaPor minutoSeparación mín.RitmoHerramientas
Lecturasopciones de publicación y listas de cuentas300030——post_optionsget_insights
Publicaciones10230 s2–5 screate_post
Publicaciones programadaslistar y cancelar————list_scheduled_postscancel_scheduled_post
Lecturas3000/día
opciones de publicación y listas de cuentas
30/min · sin ritmo
post_optionsget_insights
Publicaciones10/día
2/min · separación mín. 30 s · ritmo 2–5 s
create_post
Publicaciones programadas—
listar y cancelar
list_scheduled_postscancel_scheduled_post
  • Por cada cuenta de Google Business Profile conectada, compartidos por todas las apps de IA y claves de API que la usan.
  • Los límites diarios se reinician a las 00:00 UTC; los semanales, el lunes a las 00:00 UTC.
  • Listar y cancelar publicaciones programadas se hace en Pluggzy y no consume ninguna llamada a Google Business Profile.

Reglas de publicación

Lo que Google Business Profile acepta, comprobado antes de enviar nada, para que una publicación incorrecta no cueste nada.

TextoobligatorioHasta 1500 caracteres, en text.
Archivos multimediaOpcional: una imagen (image_urls), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.
cta_typeCall-to-action buttonLEARN_MOREBOOKORDERSHOPSIGN_UPCALL
cta_urlHttps link of the button (not needed for CALL)
event_titleEvent (or offer) title; makes it an event post with event_start and event_end
event_startFirst day of the event or offer, ISO 8601 (2027-05-15)
event_endLast day of the event or offer, ISO 8601 (2027-05-16)
coupon_codeOffer coupon code (makes it an offer post, which needs event_title and dates)
offer_urlHttps link to redeem the offer online
offer_termsOffer terms and conditions

Límites de seguridad

Lo que mantiene tu cuenta de Google Business Profile en buen estado. Se aplican a todas las apps de IA y claves de API de esta cuenta, y no se pueden desactivar.

Ritmo2–5 s
Separación aleatoria entre acciones de Google Business Profile, en todas las apps y claves de esta cuenta.
Sin publicaciones duplicadas10 min
La misma publicación en la misma cuenta en menos de 10 minutos devuelve la primera respuesta en lugar de publicar dos veces.
Pausa si la red pone freno5 min
Tras una respuesta de límite de uso, la cuenta descansa al menos 5 minutos, 30 si lo pidió el propio Google Business Profile. Mientras tanto, cada llamada recibe el tiempo que falta.
Ventana de programación1 año
publish_at debe ser al menos un minuto en el futuro, y como máximo un año. Los enlaces deben seguir funcionando hasta entonces; los archivos subidos se guardan con la publicación.
Comprobado primeroGratis
El texto, el título y los archivos se revisan según las reglas de Google Business Profile antes de la llamada: una publicación que Google Business Profile rechazaría no cuesta nada.
Límite por cuenta10 / min
Como máximo 10 llamadas por minuto por cuenta en total, sin contar lecturas, además del límite por minuto de cada acción.

Cuando se alcanza un límite

Nada se pone en cola ni se reintenta a tus espaldas: la herramienta responde con un error que tu app de IA puede leer, explicarte y reintentar en el momento justo.

invalid_postLa publicación incumple una regla de Google Business Profile. El mensaje dice cuál.
gapDemasiado pronto después de la última acción. Espera retry_after_seconds.
limitSe agotó el límite diario o semanal. Indica cuándo se reinicia.
cooldownGoogle Business Profile puso freno; la cuenta está descansando.
permissionEsta app no tiene permiso para hacer eso. Vuelve a conectarla y permítelo.
Ejemplo de rechazo
isError
{
  "error": "Google Business Profile actions are spaced 2–5 s apart, at random, to look human. Wait 2s.",
  "code": "gap",
  "retry_after_seconds": 2
}

Analíticas

Lo que get_insights lee en Google Business Profile. Pregunta con tus propias palabras; tu app de IA elige el informe.

Resumenoverview predeterminadoVistas, alcance, interacción y seguidores en los últimos days, con los términos de cada red más un resumen común a todas. Sin account, todas las cuentas con analíticas lado a lado.
Mejores publicacionestop_posts Tus mejores publicaciones del periodo, ordenadas por interacción o por sort (vistas, alcance, me gusta, comentarios, compartidos, fecha). Sin account, en todas las cuentas con analíticas.
Mejor hora para publicartiming Los días de la semana y franjas horarias que mejor funcionan para tus publicaciones (en UTC), con qué frecuencia publicas frente a la interacción que recibes y lo rápido que llegan a su pico. Instagram: cuándo están conectados tus seguidores.
Palabras clave de búsquedasearch_keywords Las búsquedas de Google que mostraron tu Perfil de Empresa, mes a mes.
Una publicaciónpost Las cifras de una publicación, por el post_id de list_posts, de las mejores publicaciones o de create_post. details: true añade su curva día a día y los datos extra de la red.

Herramientas

Google Business Profile no tiene herramientas propias: usa las herramientas de publicación compartidas, que funcionan en todos los canales de publicación. Esta página muestra solo los campos que lee Google Business Profile.

6 herramientas · 3 de lectura · 3 de escritura
Publicar3

Publish a post on one connected account, right away or at publish_at (then it's scheduled: returns a scheduled_post_id for list_scheduled_posts and cancel_scheduled_post). Google Business Profile: text ≤1500, 1 image. Call post_options first for an account you haven't posted to in this conversation. Media: media_ids from upload_media (files the user has, or one you made), or public https links (image_urls, video_url); for a scheduled post, links must keep working until publish_at, uploads are kept with the post. Public and irreversible: confirm the account, final text, media, audience and time (with the user's time zone) with the user first.

Permiso Send messages & postsLímite Publicaciones · 10/díaCon ritmo 2–5 sPúblico e irreversible: confirma antes el texto y los archivos
EntradaCampos de Google Business Profile · 14 de 36
accountstring
account_id of the account to post from (list_accounts). Needed only when several accounts that can post are connected.
textstringobligatorio en Google Business Profile
The post's text (Instagram: the caption; YouTube and Pinterest: the description; WordPress: the article's HTML)
por defecto ""máx. 1500 caracteres en Google Business Profile
media_idsstring[]
media_id values from upload_media, in order (images, or one video). Instead of image_urls and video_url
1–35
image_urlsstring[]
Public https links to the images, in order
máx. 1 elementos
video_urlstring
Public https link to one video
publish_atstring
Schedule it: ISO 8601 date and time with a UTC offset, like 2026-11-03T09:30:00+01:00, at least a minute ahead, at most a year. Leave it out to publish now.
cta_typeenum
Call-to-action button
LEARN_MOREBOOKORDERSHOPSIGN_UPCALL
cta_urlstring
Https link of the button (not needed for CALL)
https://
event_titlestring
Event (or offer) title; makes it an event post with event_start and event_end
event_startstring
First day of the event or offer, ISO 8601 (2027-05-15)
event_endstring
Last day of the event or offer, ISO 8601 (2027-05-16)
coupon_codestring
Offer coupon code (makes it an offer post, which needs event_title and dates)
offer_urlstring
Https link to redeem the offer online
https://
offer_termsstring
Offer terms and conditions
SalidastructuredContent
{
  "structuredContent": {
    "url": "https://www.threads.net/@ada.martin/post/DQ3kF8sDk2L",
    "post_id": "18063215523019873",
    "published": true
  },
  "content": [
    {
      "type": "text",
      "text": "Post published."
    }
  ]
}
Mientras Google Business Profile sigue procesando
{
  "published": false,
  "status": "publishing",
  "post_id": "6914b2c8e4a1f0d3c2b5a7e9"
}
Qué hizo el filtroEjemplo09:41:02 → 09:41:04
  1. Recibida09:41:02
  2. Dentro de los límites3 de 10 hoy
  3. Espaciada+2 s
  4. Enviada09:41:04
Publicaciones hoy: 3 de 10 usados · se reinicia a las 00:00 UTC
El contenido de texto empieza con “Post published.” · Puede rechazar coninvalid_postgaplimitcooldownpermission
Publicaciones programadas2
Analíticas1
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio