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

> Optionen zum Posten mit der 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>;
};

## Posten in Google Business Profile

Es gibt vier Arten von Google-Business-Profile-Beiträgen (früher bekannt als Google My Business), die über die Google Business Profile API erstellt werden können.
Im folgenden Beispiel wird der `post`-Text als Update auf der Google-Business-Seite des Nutzers veröffentlicht.
[Erfahren Sie mehr](https://www.ayrshare.com/blog/google-my-business-what-is-gmb-why-you-need-it-and-how-to-use-it/) über Google Business Profile (GBP).

<Warning>
  Sie müssen Ihre Google-Business-Profile-Seite [beanspruchen](https://support.google.com/business/answer/2911778), bevor Sie sie mit Ayrshare verknüpfen. Stellen Sie sicher, dass Sie während der Verknüpfungsautorisierung das Google-Konto auswählen, das Administrator Ihrer GBP-Seite ist. Das Business-Profil muss außerdem verifiziert und öffentlich sein.

  Sie können auf die GBP-Verwaltungskonsole zugreifen und den Verifizierungsstatus unter [https://business.google.com/](https://business.google.com/) prüfen.
</Warning>

Produktbeiträge können derzeit nicht über die Google Business Profile API erstellt werden.

JSON für einen einfachen Beitrag mit nur Text an GBP, der im Abschnitt „What's New" erscheint:

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

oder JSON für einen einfachen Beitrag mit Bild an 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>
    Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter `isVideo`.
    Weitere Informationen finden Sie unter [/post-Endpunkt](/apis/post/overview).
  </li>

  <li>
    Weitere Informationen finden Sie unter [Google-Business-Profile-Medienrichtlinien](/media-guidelines/google_business_profile) und [Google-Business-Profile-Autorisierung](/dashboard/connect-social-accounts/google-business).
  </li>
</ul>

## Anforderungen für Google-Business-Profile-Beiträge

Stellen Sie sicher, dass Ihr Beitrag Folgendes nicht enthält. Google wird Ihren Beitrag sonst ablehnen, und er erscheint als „This post is no longer available" oder mit dem Label „Rejected" in der Google Console:

<ul class="custom-bullets">
  <li>Telefonnummern. Google lehnt alle Beiträge ab, die Telefonnummern enthalten.</li>
  <li>Spam, falsche Behauptungen oder Falschdarstellungen.</li>
  <li>Off-Topic-Beiträge, die sich nicht auf Ihr Unternehmen beziehen.</li>
  <li>Doppelte Inhalte.</li>
  <li>Unangemessene Inhalte.</li>
  <li>Anstößige Sprache.</li>
</ul>

Weitere Informationen finden Sie in der [Content-Richtlinie von Google Business Profile](https://support.google.com/business/answer/7213077?hl=en).

## Standardbeitrag (What's New)

Ein standardmäßiger lokaler Beitrag erscheint im Abschnitt „*Posts*" des GBP und wird als „What's New" kategorisiert.
Er kann Beitragstext, ein Bild oder einen Call to Action enthalten ([siehe unten](/apis/post/social-networks/google#call-to-action)).

Videos werden für die Veröffentlichung im What's-New-Abschnitt über die Google Business Profile API nicht unterstützt.
Details zur Veröffentlichung von Videos in Google Business Profile finden Sie unter [Bild- oder Videobeitrag](#image-or-video-post).

*Diese Beiträge erscheinen im Abschnitt „**Posts -> What's New**" in der GMB-Verwaltungskonsole.*

```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"
    }
  }
}
```

## Bild- oder Videobeitrag

Sie können Bild- oder Videobeiträge in Google Business Profile veröffentlichen.
Bilder und Videos erscheinen im Abschnitt „**Photos**" in der GBP-Verwaltungskonsole.

### Anforderungen

<ul class="custom-bullets">
  <li>
    Ihrem GBP-Standort kann nur ein Bild oder ein Video hinzugefügt werden, das im Abschnitt „Photos"
    der GBP-Konsole erscheint.
  </li>

  <li>Pro Beitrag ist nur ein Bild oder Video erlaubt.</li>
  <li>Der Beitragstext wird vom Endpunkt verlangt, aber von GBP nicht verwendet.</li>
  <li>Call to Action wird für Bild- oder Videobeiträge nicht unterstützt.</li>
  <li>Achten Sie darauf, den Parameter `isPhotoVideo` im Objekt `gmbOptions` anzugeben.</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
  }
}
```

### Videoverarbeitung

Google benötigt manchmal zusätzliche Zeit, um hochgeladene Videos zu verarbeiten.

Sie können den Status des Mediums in der Google-Business-Profile-Konsole einsehen:

1. Gehen Sie zu Ihrer [Google-Business-Profile-Konsole](https://business.google.com/us/business-profile/).
2. Klicken Sie auf die Schaltfläche „See your profile". Sie werden zur GBP-Seite weitergeleitet.
3. Klicken Sie auf den Tab „Photos".
4. Sie sehen eine Liste von Fotos und Videos.
5. Klicken Sie auf das Foto oder Video, das Sie ansehen möchten.

<Warning>
  Wenn Ihr Video den Status „pending" hat, wird es noch von Google verarbeitet. Warten Sie einige
  Minuten und aktualisieren Sie die Seite. Stellen Sie sicher, dass Ihr Google Business Profile verifiziert und
  öffentlich ist.

  Bleibt das Video scheinbar dauerhaft in „pending", kann dies an einem Bug bei Google liegen.
  Wenden Sie sich für Unterstützung an den [Google-Business-Support](https://support.google.com/business/gethelp).
</Warning>

### Produktkategorie

Sie können eine Produktkategorie für ein Bild oder Video angeben, damit das Medium im Abschnitt „Photos" der GBP-Konsole entsprechend kategorisiert wird. Hat ein Bild beispielsweise die Kategorie „product", erscheint es im Tab „Product" unter Photos.

Einige Kategorien sind für bestimmte Geschäftsarten nicht zulässig. Zum Beispiel konnte Ayrshare `food_and_drink` nicht verwenden, da wir nicht in der Lebensmittel-/Getränkebranche tätig sind.

Verfügbare Kategorien:

<ul class="custom-bullets">
  <li>`cover`: Titelbild. Ein Standort hat nur ein Titelbild.</li>
  <li>`profile`: Profilbild. Ein Standort hat nur ein Profilbild.</li>
  <li>`logo`: Logo-Foto.</li>
  <li>`exterior`: Außenaufnahmen.</li>
  <li>`interior`: Innenaufnahmen.</li>
  <li>`product`: Produktmedien.</li>
  <li>`at_work`: Medien bei der Arbeit.</li>
  <li>`food_and_drink`: Medien zu Speisen und Getränken.</li>
  <li>`menu`: Menü-Medien.</li>
  <li>`common_area`: Medien zu Gemeinschaftsbereichen.</li>
  <li>`rooms`: Medien zu Räumen.</li>
  <li>`teams`: Team-Medien.</li>
</ul>

## Event-Beitrag

Bewerben Sie ein Event in Ihrem Unternehmen. Events benötigen einen Titel, ein Start- und Enddatum und können ein Video enthalten. Zum Beispiel kann ein Immobilienmakler einen Tag der offenen Tür bewerben.

<ul class="custom-bullets">
  <li>Events unterstützen Call to Action.</li>
  <li>Fügen Sie optional ein Bild über den Parameter `mediaUrls` hinzu.</li>
  <li>Videos werden für Events nicht unterstützt.</li>

  <li>
    Event-Beiträge erscheinen im Abschnitt „**Posts -> Events**" in der GBP-Verwaltungskonsole.
  </li>

  <li>Der `post`-Text wird für die Event-Details verwendet.</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
    }
  }
}
```

## Angebots-Beitrag

Bewerben Sie Rabatte oder Angebote Ihres Unternehmens. Angebote benötigen einen Titel sowie Start- und Enddatum mit Uhrzeit. Eine Schaltfläche „View offer" wird automatisch zum Beitrag hinzugefügt. Sie können zusätzlich ein Foto, eine Beschreibung, einen Gutscheincode, einen Link sowie Geschäftsbedingungen zum Beitrag hinzufügen. Ein Spielwarengeschäft kann so etwa 20 % Rabatt auf alle Beanie Babies für eine Woche bewerben.

Fügen Sie über den Parameter `mediaUrls` ein Bild hinzu.

*Videos werden für Angebote nicht unterstützt.*

*Diese Beiträge erscheinen im Abschnitt „**Posts -> Offers**" in der GBP-Verwaltungskonsole.*

```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` hat maximal 58 Zeichen.</li>
</ul>

## Call to Action

Stellen Sie allgemeine Informationen zu Ihrem Unternehmen bereit, die als Aktionsschaltfläche erscheinen. Zum Beispiel kann eine Website eine Schaltfläche „Learn More" bewerben, um Nutzer auf ihre Website weiterzuleiten.

Ein Call to Action kann zu einem Standardbeitrag oder Event hinzugefügt werden. Angebote können keinen Call to Action haben.

Fügen Sie über den Parameter `mediaUrls` ein Bild hinzu.

```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"
    }
  }
}
```

Der `actionType` wird als Schaltfläche im Beitrag angezeigt. Mögliche Werte:

<ul class="custom-bullets">
  <li>**book**: Fordert einen Nutzer auf, einen Termin, Tisch oder Ähnliches zu buchen.</li>
  <li>**order**: Fordert einen Nutzer auf, etwas zu bestellen.</li>
  <li>**shop**: Fordert einen Nutzer auf, einen Produktkatalog zu durchstöbern.</li>
  <li>**learn\_more**: Fordert einen Nutzer auf, weitere Details auf einer Website anzusehen.</li>
  <li>**sign\_up**: Fordert einen Nutzer auf, sich zu registrieren, anzumelden oder beizutreten.</li>

  <li>
    **call**: Fordert einen Nutzer auf, ein Unternehmen anzurufen. Das Feld `url` ist für `call` nicht erforderlich.
    Es muss jedoch zuvor eine Telefonnummer in Ihrem Google Business Profile hinterlegt worden sein, damit die Anrufaktion
    im Beitrag erscheint.
  </li>
</ul>

Der Parameter `url` ist die URL, zu der der Nutzer beim Klick weitergeleitet wird.

Weitere [Informationen zu 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-Verknüpfung" icon="link" href="/dashboard/connect-social-accounts/google-business" horizontal />

## First Comment

Google Business Profile unterstützt keine Kommentare zu Beiträgen, daher wird der Parameter `firstComment` für reine Google-Business-Profile-Beiträge übersprungen.
Es wird ein `firstComment`-Warn-/Skip-Objekt zurückgegeben, der Beitrag selbst ist jedoch weiterhin erfolgreich und es wird kein Fehler ausgelöst.

## Google-Business-Profile-Erwähnungen

Sie können zwar ein `@handle` in einen Google-Business-Profile-Beitrag einfügen, Google Business Profile unterstützt aber keine Auflösung von Erwähnungen im Beitragstext.
Das `@handle` bleibt als reiner Text bestehen.

## Zeichenbeschränkungen

Weitere Informationen finden Sie unter [Google-Business-Profile-Zeichenbeschränkungen](/help-center/technical-support/character_limits#google-business-profile-character-limits).