> ## 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 do Google Business Profile

> Opções para publicar usando a API do 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>;
};

## Publicando no Google Business Profile

Existem quatro tipos de publicações do Google Business Profile, anteriormente conhecido como Google My Business, que podem ser criadas usando a API do Google Business Profile.
No exemplo abaixo, o texto `post` é publicado como uma atualização na página do Google Business do usuário.
[Saiba mais](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/) sobre o Google Business Profile (GBP).

<Warning>
  Você deve [reivindicar](https://support.google.com/business/answer/2911778) sua página do Google Business Profile antes de vinculá-la ao Ayrshare. Certifique-se de escolher a conta do Google que é administradora da sua página GBP durante a autorização do vínculo. O perfil comercial também deve estar verificado e público.

  Você pode acessar o console de gerenciamento do GBP e verificar o status de verificação em [https://business.google.com/](https://business.google.com/)
</Warning>

Publicações de produto não podem ser criadas via API do Google Business Profile no momento.

JSON para uma publicação básica apenas com texto no GBP, que aparecerá na seção "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`
}
```

ou JSON para uma publicação básica com uma imagem no 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>
    Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro `isVideo`.
    Consulte o [endpoint /post](/apis/post/overview) para detalhes.
  </li>

  <li>
    Consulte as [Diretrizes de mídia do Google Business Profile](/media-guidelines/google_business_profile) e a [Autorização do Google Business Profile](/dashboard/connect-social-accounts/google-business) para mais informações.
  </li>
</ul>

## Requisitos de publicação no Google Business Profile

Certifique-se de que sua publicação não contém os seguintes elementos. Caso contrário, o Google rejeitará sua publicação e ela será exibida como "Esta publicação não está mais disponível" ou com uma etiqueta "Rejected" no Google Console:

<ul class="custom-bullets">
  <li>Números de telefone. O Google rejeitará todas as publicações que contenham números de telefone.</li>
  <li>Spam, falsas alegações ou representação falsa.</li>
  <li>Publicações fora do tópico que não pertencem ao seu negócio.</li>
  <li>Conteúdo duplicado.</li>
  <li>Conteúdo inadequado.</li>
  <li>Linguagem ofensiva.</li>
</ul>

Consulte a [Política de Conteúdo do Google Business Profile](https://support.google.com/business/answer/7213077?hl=en) para mais informações.

## Publicação padrão (What's New)

Uma publicação local padrão aparece na seção "*Posts*" do GBP e é categorizada como "What's New".
Pode conter texto, uma imagem ou uma Call to Action ([veja abaixo](/apis/post/social-networks/google#call-to-action)).

Vídeos não são suportados para publicação na seção What's New via API do Google Business Profile.
Consulte [Publicação de imagem ou vídeo](#image-or-video-post) para detalhes sobre como publicar vídeos no Google Business Profile.

*Essas publicações aparecerão na seção "**Posts -> What's New**" no console de gerenciamento do 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"
    }
  }
}
```

## Publicação de imagem ou vídeo

Você pode publicar publicações de imagem ou vídeo no Google Business Profile.
Imagens e vídeos aparecerão na seção "**Photos**" no console de gerenciamento do GBP.

### Requisitos

<ul class="custom-bullets">
  <li>
    Apenas uma imagem ou um vídeo pode ser adicionado à sua localização do GBP, o qual aparecerá na seção "Photos"
    do console do GBP.
  </li>

  <li>Apenas uma imagem ou vídeo é permitido por publicação.</li>
  <li>O texto da publicação é obrigatório pelo endpoint, mas não é usado pelo GBP.</li>
  <li>A Call to Action não é suportada em publicações de imagem ou vídeo.</li>
  <li>Certifique-se de incluir o parâmetro `isPhotoVideo` no 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
  }
}
```

### Processamento de vídeo

O Google, às vezes, leva um tempo extra para processar os vídeos enviados.

Você pode ver o status da mídia no console do Google Business Profile:

1. Vá ao seu [console do Google Business Profile](https://business.google.com/us/business-profile/).
2. Clique no botão "See your profile". Você será direcionado à página do GBP.
3. Clique na aba "Photos".
4. Você verá uma lista de fotos e vídeos.
5. Clique na foto ou vídeo que deseja visualizar.

<Warning>
  Se seu vídeo estiver com status "pending", ele ainda está sendo processado pelo Google. Aguarde alguns
  minutos e atualize a página. Certifique-se de que seu Google Business Profile foi verificado e o
  perfil é público.

  Se o vídeo parecer preso em "pending", isso pode ser devido a um bug no Google.
  Entre em contato com o [suporte do Google Business](https://support.google.com/business/gethelp)
  para obter assistência.
</Warning>

### Categoria de produto

Você pode especificar uma categoria de produto para uma imagem ou vídeo, de modo que a mídia seja categorizada na seção "Photos" do console do GBP. Por exemplo, se uma imagem tiver a categoria "product", ela aparecerá na aba "Product" em Photos.

Algumas categorias não são permitidas para determinados tipos de negócios. Por exemplo, o Ayrshare não pôde usar `food_and_drink`, já que não está no setor de alimentação/bebidas.

Categorias disponíveis:

<ul class="custom-bullets">
  <li>`cover`: Foto de capa. Uma localização tem apenas uma foto de capa.</li>
  <li>`profile`: Foto de perfil. Uma localização tem apenas uma foto de perfil.</li>
  <li>`logo`: Foto de logotipo.</li>
  <li>`exterior`: Mídia de exterior.</li>
  <li>`interior`: Mídia de interior.</li>
  <li>`product`: Mídia de produto.</li>
  <li>`at_work`: Mídia no trabalho.</li>
  <li>`food_and_drink`: Mídia de alimentação e bebida.</li>
  <li>`menu`: Mídia de menu.</li>
  <li>`common_area`: Mídia de área comum.</li>
  <li>`rooms`: Mídia de quartos.</li>
  <li>`teams`: Mídia de equipes.</li>
</ul>

## Publicação de eventos

Promova um evento em seu negócio. Eventos exigem um título, datas de início e término e podem incluir um vídeo. Por exemplo, um corretor de imóveis pode anunciar uma visita de open house.

<ul class="custom-bullets">
  <li>Eventos suportam Call to Action.</li>
  <li>Inclua uma imagem opcional com o parâmetro `mediaUrls`.</li>
  <li>Vídeos não são suportados para eventos.</li>

  <li>
    Publicações de evento aparecerão na seção "**Posts -> Events**" no console de gerenciamento do GBP.
  </li>

  <li>O texto de `post` será usado para os detalhes do evento.</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
    }
  }
}
```

## Publicação de ofertas

Ofereça vendas promocionais ou ofertas do seu negócio. Ofertas exigem um título e datas e horários de início e término. Um botão de ação "View offer" é adicionado automaticamente à publicação. Você também pode incluir foto, descrição, código de cupom, link e termos e condições na publicação. Por exemplo, uma loja de brinquedos pode anunciar 20% de desconto em todos os beanie babies por uma semana.

Inclua uma imagem com o parâmetro `mediaUrls`.

*Vídeos não são suportados para ofertas.*

*Essas publicações aparecerão na seção "**Posts -> Offers**" no console de gerenciamento do 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` tem no máximo 58 caracteres.</li>
</ul>

## Call to Action

Forneça informações gerais sobre seu negócio, exibidas como um botão de ação. Por exemplo, um site pode promover um botão *Learn More* para redirecionar para o site.

Uma Call to Action pode ser adicionada a uma publicação padrão ou evento. Ofertas não podem ter Call to Actions.

Inclua uma imagem com o 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"
    }
  }
}
```

O `actionType` é exibido como um botão na publicação. Valores possíveis:

<ul class="custom-bullets">
  <li>**book**: Solicita que um usuário reserve um horário, uma mesa ou algo semelhante.</li>
  <li>**order**: Solicita que um usuário faça um pedido.</li>
  <li>**shop**: Solicita que um usuário navegue por um catálogo de produtos.</li>
  <li>**learn\_more**: Solicita que um usuário veja detalhes adicionais em um site.</li>
  <li>**sign\_up**: Solicita que um usuário se registre, cadastre-se ou entre em algo.</li>

  <li>
    **call**: Solicita que um usuário ligue para um negócio. O campo `url` não é obrigatório para `call`.
    No entanto, você deve primeiro ter definido um número de telefone em seu Google Business Profile para que a ação de ligação
    apareça na publicação.
  </li>
</ul>

O parâmetro `url` é a URL para a qual o usuário será direcionado ao clicar.

Informações adicionais sobre o [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="Vinculação do Google Business Profile" icon="link" href="/dashboard/connect-social-accounts/google-business" horizontal />

## Primeiro comentário

O Google Business Profile não suporta comentários em publicações, portanto o parâmetro `firstComment` é ignorado em publicações somente do Google Business Profile.
Um objeto de aviso/pulo (`firstComment`) é retornado, mas a publicação em si ainda é bem-sucedida, sem gerar erro.

## Menções no Google Business Profile

Embora você possa adicionar um `@handle` a uma publicação do Google Business Profile, o Google Business Profile não suporta a resolução de menções no texto da publicação.
O `@handle` permanecerá como texto simples.

## Limites de caracteres

Consulte [Limites de caracteres do Google Business Profile](/help-center/technical-support/character_limits#google-business-profile-character-limits) para mais informações.