> ## 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.

# Google Business Profile API

> Опції публікації через Google Business Profile API

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>;
};

## Публікація в Google Business Profile

Існує чотири типи публікацій Google Business Profile (раніше відомий як Google My Business), які можна створювати за допомогою Google Business Profile API.
У прикладі нижче текст `post` публікується як оновлення на сторінці бізнесу Google користувача.
[Дізнайтеся більше](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/) про Google Business Profile (GBP).

<Warning>
  Ви повинні [підтвердити право власності](https://support.google.com/business/answer/2911778) на вашу сторінку Google Business Profile перед тим, як пов'язати її з Ayrshare. Обов'язково виберіть обліковий запис Google, який є адміністратором вашої сторінки GBP, під час авторизації прив'язки. Бізнес-профіль також має бути верифікований і публічний.

  Ви можете отримати доступ до консолі керування GBP та перевірити статус верифікації за адресою [https://business.google.com/](https://business.google.com/)
</Warning>

Публікації продуктів наразі неможливо створювати через Google Business Profile API.

JSON для базової публікації лише з текстом у GBP, яка з'явиться в розділі "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`
}
```

або JSON для базової публікації із зображенням у 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>
    Якщо ваше відео не має відомого розширення (наприклад, mp4), використайте параметр `isVideo`.
    Див. [/post endpoint](/apis/post/overview) для деталей.
  </li>

  <li>
    Див. [Google Business Profile Media Guidelines](/media-guidelines/google_business_profile) та [Google Business Profile Authorization](/dashboard/connect-social-accounts/google-business) для отримання додаткової інформації.
  </li>
</ul>

## Вимоги до публікації в Google Business Profile

Переконайтеся, що ваша публікація не містить наведеного нижче. Google відхилить вашу публікацію, і вона з'явиться як "This post is no longer available" або з міткою "Rejected" у Google Console:

<ul class="custom-bullets">
  <li>Номери телефонів. Google відхилить усі публікації, що містять номери телефонів.</li>
  <li>Спам, неправдиві твердження або хибне представлення.</li>
  <li>Не за темою — публікація, яка не стосується вашого бізнесу.</li>
  <li>Дубльований контент.</li>
  <li>Неприйнятний контент.</li>
  <li>Образлива лексика.</li>
</ul>

Див. [Google Business Profile's Content Policy](https://support.google.com/business/answer/7213077?hl=en) для отримання додаткової інформації.

## Стандартна публікація (What's New)

Стандартна локальна публікація з'являється у розділі GBP "*Posts*" і категоризується як "What's New".
Вона може містити текст публікації, зображення або Call to Action ([див. нижче](/apis/post/social-networks/google#call-to-action)).

Відео не підтримуються для публікації в розділі What's New через Google Business Profile API.
Див. [Image or Video Post](#image-or-video-post) для деталей щодо публікації відео в Google Business Profile.

*Ці публікації з'являться в розділі "**Posts -> What's New**" консолі керування 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"
    }
  }
}
```

## Публікація зображення або відео

Ви можете публікувати зображення або відео в Google Business Profile.
Зображення та відео з'являться в розділі "**Photos**" консолі керування GBP.

### Вимоги

<ul class="custom-bullets">
  <li>
    Лише одне зображення або одне відео можна додати до вашої локації GBP, яке з'явиться в розділі "Photos"
    консолі GBP.
  </li>

  <li>Дозволено лише одне зображення або одне відео на публікацію.</li>
  <li>Текст публікації обов'язковий для endpoint, але не використовується GBP.</li>
  <li>Call to Action не підтримується для публікацій із зображенням або відео.</li>
  <li>Обов'язково додайте параметр `isPhotoVideo` в об'єкт `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
  }
}
```

### Обробка відео

Google іноді потребує додаткового часу на обробку завантажених відео.

Ви можете переглянути статус медіа в консолі Google Business Profile:

1. Перейдіть до вашої [консолі Google Business Profile](https://business.google.com/us/business-profile/).
2. Натисніть кнопку "See your profile". Ви потрапите на сторінку GBP.
3. Клацніть на вкладку "Photos".
4. Ви побачите список фото та відео.
5. Клацніть на фото чи відео, яке хочете переглянути.

<Warning>
  Якщо ваше відео має статус "pending", воно все ще обробляється Google. Зачекайте кілька
  хвилин і оновіть сторінку. Переконайтеся, що ваш Google Business Profile верифіковано, а
  профіль є публічним.

  Якщо відео, здається, застрягло на "pending", це може бути через баг на боці Google.
  Зверніться до [підтримки Google Business](https://support.google.com/business/gethelp) для
  допомоги.
</Warning>

### Категорія продукту

Ви можете вказати категорію продукту для зображення чи відео, щоб медіа було категоризовано в розділі "Photos" консолі GBP. Наприклад, якщо зображення має категорію "product", воно з'явиться на вкладці "Product" у Photos.

Деякі категорії не дозволені для певних типів бізнесу. Наприклад, Ayrshare не може використовувати `food_and_drink`, оскільки ми не в галузі їжі та напоїв.

Доступні категорії:

<ul class="custom-bullets">
  <li>`cover`: обкладинка. Локація має лише одне фото обкладинки.</li>
  <li>`profile`: фото профілю. Локація має лише одне фото профілю.</li>
  <li>`logo`: фото логотипа.</li>
  <li>`exterior`: зовнішні медіа.</li>
  <li>`interior`: внутрішні медіа.</li>
  <li>`product`: медіа продукту.</li>
  <li>`at_work`: медіа "у роботі".</li>
  <li>`food_and_drink`: медіа їжі та напоїв.</li>
  <li>`menu`: медіа меню.</li>
  <li>`common_area`: медіа спільних зон.</li>
  <li>`rooms`: медіа кімнат.</li>
  <li>`teams`: медіа команд.</li>
</ul>

## Публікація події

Промоуйте подію у вашому бізнесі. Події вимагають назви, дат початку та завершення і можуть включати відео. Наприклад, агент з нерухомості може рекламувати день відкритих дверей.

<ul class="custom-bullets">
  <li>Події підтримують Call to Action.</li>
  <li>Додайте необов'язкове зображення за допомогою параметра `mediaUrls`.</li>
  <li>Відео не підтримуються для подій.</li>

  <li>
    Публікації подій з'являться в розділі "**Posts -> Events**" консолі керування GBP.
  </li>

  <li>Текст `post` буде використано для деталей події (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
    }
  }
}
```

## Публікація пропозицій (Offers)

Надавайте акційні розпродажі або пропозиції від вашого бізнесу. Пропозиції вимагають назви, а також дат і часу початку та завершення. Кнопка дії "View offer" додається до публікації автоматично. Ви також можете додати фото, опис, промокод, посилання та умови й положення. Наприклад, магазин іграшок може рекламувати знижку 20% на всіх beanie babies протягом тижня.

Додайте зображення за допомогою параметра `mediaUrls`.

*Відео не підтримуються для Offers.*

*Ці публікації з'являться в розділі "**Posts -> Offers**" консолі керування 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` має максимум 58 символів.</li>
</ul>

## Call to Action

Надайте загальну інформацію про ваш бізнес, яка з'являється як кнопка дії. Наприклад, вебсайт може просувати кнопку *Learn More* для перенаправлення на свій сайт.

Call to Action можна додати до стандартної публікації або події. Пропозиції (Offers) не можуть мати Call to Action.

Додайте зображення за допомогою параметра `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"
    }
  }
}
```

`actionType` відображається як кнопка на публікації. Можливі значення:

<ul class="custom-bullets">
  <li>**book**: спонукає користувача забронювати зустріч, столик або щось подібне.</li>
  <li>**order**: спонукає користувача щось замовити.</li>
  <li>**shop**: спонукає користувача переглянути каталог продуктів.</li>
  <li>**learn\_more**: спонукає користувача переглянути додаткові деталі на вебсайті.</li>
  <li>**sign\_up**: спонукає користувача зареєструватися, підписатися або приєднатися до чогось.</li>

  <li>
    **call**: спонукає користувача зателефонувати до бізнесу. Поле `url` не є обов'язковим для `call`.
    Однак ви повинні спершу встановити номер телефону у своєму Google Business Profile, щоб кнопка дзвінка
    з'явилася на публікації.
  </li>
</ul>

Параметр `url` — це URL, на який користувач буде спрямований після кліку.

Додаткова [інформація про 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="Google Business Profile Linking" icon="link" href="/dashboard/connect-social-accounts/google-business" horizontal />

## Перший коментар

Google Business Profile не підтримує коментарі до публікацій, тому параметр `firstComment` пропускається для публікацій лише в Google Business Profile.
Повертається об'єкт `firstComment` warning/skip, але сама публікація все одно виконується без помилки.

## Згадки в Google Business Profile

Хоча ви можете додати `@handle` до публікації Google Business Profile, Google Business Profile не підтримує розпізнавання згадок у тексті публікації.
`@handle` залишиться простим текстом.

## Обмеження на кількість символів

Див. [обмеження на кількість символів у Google Business Profile](/help-center/technical-support/character_limits#google-business-profile-character-limits) для отримання додаткової інформації.