> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Google Business Profile

> Opciones para publicar usando la API de Google Business Profile

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

## Publicar en Google Business Profile

Existen cuatro tipos de publicaciones en Google Business Profile, antes conocido como Google My Business, que se pueden crear con la API de Google Business Profile.
En el siguiente ejemplo, el texto de `post` se publica como una actualización en la página de Google del negocio.
[Más información](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/) sobre Google Business Profile (GBP).

<Warning>
  Debes [reclamar](https://support.google.com/business/answer/2911778) tu página de Google Business Profile antes de vincularla con Ayrshare. Asegúrate de elegir la cuenta de Google que es administradora de tu página de GBP durante la autorización del vínculo. El perfil de empresa también debe estar verificado y ser público.

  Puedes acceder a la consola de gestión de GBP y comprobar el estado de verificación en [https://business.google.com/](https://business.google.com/)
</Warning>

Actualmente no se pueden crear publicaciones de producto mediante la API de Google Business Profile.

JSON para una publicación básica solo con texto en GBP, que aparecerá en la sección "What's New":

```json Google Business Profile Post theme={"system"}
{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}
```

o JSON para una publicación básica con imagen en GBP:

```json Google Business Profile Post with Image theme={"system"}
{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}
```

<ul class="custom-bullets">
  <li>
    Si tu video no termina en una extensión de video conocida como mp4, usa el parámetro `isVideo`.
    Consulta el [endpoint /post](/apis/post/overview) para más detalles.
  </li>

  <li>
    Consulta las [pautas de medios de Google Business Profile](/media-guidelines/google_business_profile) y la [autorización de Google Business Profile](/dashboard/connect-social-accounts/google-business) para más información.
  </li>
</ul>

## Requisitos para publicar en Google Business Profile

Asegúrate de que tu publicación no contiene lo siguiente. Google rechazará tu publicación y aparecerá como "This post is no longer available" o con la etiqueta "Rejected" en la Google Console:

<ul class="custom-bullets">
  <li>Números de teléfono. Google rechazará cualquier publicación que contenga números de teléfono.</li>
  <li>Spam, afirmaciones falsas o representaciones engañosas.</li>
  <li>Contenido fuera de tema que no esté relacionado con tu negocio.</li>
  <li>Contenido duplicado.</li>
  <li>Contenido inapropiado.</li>
  <li>Lenguaje ofensivo.</li>
</ul>

Consulta la [Política de contenido de Google Business Profile](https://support.google.com/business/answer/7213077?hl=en) para más información.

## Publicación estándar (What's New)

Una publicación local estándar aparece en la sección "*Posts*" de GBP y se clasifica como "What's New".
Puede contener texto de publicación, una imagen o una Call to Action (llamada a la acción; [ver abajo](/apis/post/social-networks/google#call-to-action)).

Los videos no se admiten para su publicación en la sección What's New a través de la API de Google Business Profile.
Consulta [Publicación de imagen o video](#image-or-video-post) para ver cómo publicar videos en Google Business Profile.

*Estas publicaciones aparecerán en la sección "**Posts -> What's New**" de la consola de gestión de GMB.*

```json Google Business Profile Standard Post theme={"system"}
{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}
```

## Publicación de imagen o video

Puedes publicar imágenes o videos en Google Business Profile.
Las imágenes y los videos aparecerán en la sección "**Photos**" de la consola de gestión de GBP.

### Requisitos

<ul class="custom-bullets">
  <li>
    Solo se puede añadir una imagen o un video a tu ubicación de GBP, que aparecerá en la sección "Photos"
    de la consola de GBP.
  </li>

  <li>Solo se permite una imagen o un video por publicación.</li>
  <li>El endpoint requiere el texto de la publicación, pero GBP no lo utiliza.</li>
  <li>Call to Action no se admite para publicaciones de imagen o video.</li>
  <li>Asegúrate de incluir el parámetro `isPhotoVideo` en el objeto `gmbOptions`.</li>
</ul>

```json Google Business Profile Image Post {6} theme={"system"}
{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}
```

### Procesamiento de video

En ocasiones, Google tarda más tiempo en procesar los videos subidos.

Puedes ver el estado del medio en la consola de Google Business Profile:

1. Ve a tu [consola de Google Business Profile](https://business.google.com/us/business-profile/).
2. Haz clic en el botón "See your profile". Se abrirá la página de GBP.
3. Haz clic en la pestaña "Photos".
4. Verás una lista de fotos y videos.
5. Haz clic en la foto o el video que quieras ver.

<Warning>
  Si tu video tiene el estado "pending", Google todavía lo está procesando. Espera unos
  minutos y actualiza la página. Asegúrate de que tu Google Business Profile esté verificado y el
  perfil sea público.

  Si el video parece atascado en "pending", puede deberse a un error de Google.
  Contacta con el [soporte de Google Business](https://support.google.com/business/gethelp) para
  obtener ayuda.
</Warning>

### Categoría de producto

Puedes especificar una categoría de producto para una imagen o un video, de modo que el medio se clasifique en la sección "Photos" de la consola de GBP. Por ejemplo, si una imagen tiene la categoría "product", aparecerá en la pestaña "Product" dentro de Photos.

Algunas categorías no están permitidas para determinados tipos de negocio. Por ejemplo, Ayrshare no podría usar `food_and_drink` porque no pertenece al sector de comida/bebida.

Categorías disponibles:

<ul class="custom-bullets">
  <li>`cover`: foto de portada. Una ubicación solo tiene una foto de portada.</li>
  <li>`profile`: foto de perfil. Una ubicación solo tiene una foto de perfil.</li>
  <li>`logo`: foto del logo.</li>
  <li>`exterior`: medios de exterior.</li>
  <li>`interior`: medios de interior.</li>
  <li>`product`: medios de producto.</li>
  <li>`at_work`: medios en el trabajo.</li>
  <li>`food_and_drink`: medios de comida y bebida.</li>
  <li>`menu`: medios de menú.</li>
  <li>`common_area`: medios de zonas comunes.</li>
  <li>`rooms`: medios de habitaciones.</li>
  <li>`teams`: medios de equipos.</li>
</ul>

## Publicación de evento

Promociona un evento en tu negocio. Los eventos requieren un título, fechas de inicio y fin, y pueden incluir un video. Por ejemplo, un agente inmobiliario puede anunciar una jornada de puertas abiertas.

<ul class="custom-bullets">
  <li>Los eventos admiten Call to Action.</li>
  <li>Incluye una imagen opcional con el parámetro `mediaUrls`.</li>
  <li>Los videos no se admiten en los eventos.</li>

  <li>
    Las publicaciones de evento aparecerán en la sección "**Posts -> Events**" de la consola de gestión de GBP.
  </li>

  <li>El texto de `post` se usará como Event Details.</li>
</ul>

```json Google Business Profile Event Post theme={"system"}
{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}
```

## Publicación de ofertas

Ofrece promociones u ofertas de tu negocio. Las ofertas requieren un título y fechas y horas de inicio y fin. Se añade automáticamente un botón "View offer" a la publicación. También puedes incluir foto, descripción, código de cupón, enlace y términos y condiciones. Por ejemplo, una juguetería puede anunciar un 20% de descuento en todos los beanie babies durante una semana.

Incluye una imagen con el parámetro `mediaUrls`.

*Los videos no se admiten en Ofertas.*

*Estas publicaciones aparecerán en la sección "**Posts -> Offers**" de la consola de gestión de GBP.*

```json Google Business Profile Offers Post theme={"system"}
{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}
```

<ul class="custom-bullets">
  <li>`couponCode` tiene un máximo de 58 caracteres.</li>
</ul>

## Call to Action

Ofrece información general sobre tu negocio y aparece como un botón de acción. Por ejemplo, un sitio web podría promocionar un botón *Learn More* que redirija a su web.

Se puede añadir una Call to Action a una publicación estándar o a un evento. Las ofertas no pueden tener Call to Action.

Incluye una imagen con el parámetro `mediaUrls`.

```json Google Business Profile Call to Action Post theme={"system"}
{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}
```

El `actionType` se muestra como un botón en la publicación. Los valores posibles son:

<ul class="custom-bullets">
  <li>**book**: invita al usuario a reservar una cita, mesa o similar.</li>
  <li>**order**: invita al usuario a pedir algo.</li>
  <li>**shop**: invita al usuario a explorar un catálogo de productos.</li>
  <li>**learn\_more**: invita al usuario a ver más detalles en un sitio web.</li>
  <li>**sign\_up**: invita al usuario a registrarse, apuntarse o unirse a algo.</li>

  <li>
    **call**: invita al usuario a llamar al negocio. El campo `url` no es obligatorio para `call`.
    Sin embargo, primero debes haber establecido un número de teléfono en tu Google Business Profile para que aparezca la acción de llamada
    en la publicación.
  </li>
</ul>

El parámetro `url` es la URL a la que se dirigirá al usuario al hacer clic.

Más [información sobre Google Business Profile](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/).

<Card title="Vinculación de Google Business Profile" icon="link" href="/dashboard/connect-social-accounts/google-business" horizontal />

## Primer comentario

Google Business Profile no admite comentarios en publicaciones, por lo que el parámetro `firstComment` se omite en publicaciones exclusivas de Google Business Profile.
Se devuelve un objeto de advertencia/omisión para `firstComment`, pero la publicación en sí sigue teniendo éxito y no se genera un error.

## Menciones en Google Business Profile

Aunque puedes añadir un `@handle` a una publicación de Google Business Profile, Google Business Profile no admite la resolución de menciones en el texto.
El `@handle` permanecerá como texto plano.

## Límites de caracteres

Consulta los [límites de caracteres de Google Business Profile](/help-center/technical-support/character_limits#google-business-profile-character-limits) para más información.