Skip to main content
PATCH
Nutzer aktualisieren
Aktualisieren Sie die Konto- oder Nutzerdaten des sozialen Netzwerks. Derzeit werden Google Business Profile und WhatsApp unterstützt.
Google beschränkt die Aktualisierung einiger Standortfelder in Google Business Profile auf 5 Aktualisierungen innerhalb eines rollierenden 24-Stunden-Zeitraums. Beispielsweise führt die Aktualisierung von phoneNumbers mehr als 5 Mal in einem rollierenden 24-Stunden-Zeitraum zu einer 400-Antwort. Diese Begrenzung gilt nur für Google Business Profile und nicht für WhatsApp.

Header-Parameter

Pfad-Parameter

string
erforderlich
Werte: gbp, whatsapp

Body-Parameter

object
Objekt mit den verschiedenen Telefonnummern, unter denen Kunden das Unternehmen erreichen können.
string
Google-Kennung für diesen Standort in der Form.
string
Eine alternative Telefonnummer, die in AdWords-Standorterweiterungen anstelle der primären Telefonnummer des Standorts angezeigt wird.
string
Externe Kennung für diesen Standort, die innerhalb eines Kontos eindeutig sein muss. Damit können Sie den Standort mit Ihren eigenen Datensätzen verknüpfen.
string
Der Standortname sollte den realen Namen Ihres Unternehmens widerspiegeln, wie er konsistent auf Ihrem Ladenlokal, Ihrer Website und Ihren Geschäftsunterlagen verwendet wird und Ihren Kunden bekannt ist.
string
Eine URL für dieses Unternehmen.
array
Eine Sammlung von frei formulierbaren Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind für Nutzer nicht sichtbar; nur Sie können sie sehen. Muss zwischen 1 und 255 Zeichen pro Label liegen.
object
Ein Objekt, das ein Paar aus Breiten-/Längengrad darstellt. Dies wird als Paar von Doubles ausgedrückt, um Breitengrad und Längengrad in Grad darzustellen. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen.
Werte müssen innerhalb normalisierter Bereiche liegen.Der Breitengrad in Grad. Er muss im Bereich [-90.0, +90.0] liegen.Der Längengrad in Grad. Er muss im Bereich [-180.0, +180.0] liegen.
object
Dieses Feld enthält eine Beschreibung des Standorts in Ihren eigenen Worten. Die Beschreibung kann von niemand anderem bearbeitet werden.

WhatsApp

WhatsApp befindet sich in der Private Beta. Die Aktualisierung eines WhatsApp-Business-Profils erfordert ein für WhatsApp freigeschaltetes Konto. Wenn Sie frühzeitigen Zugang wünschen, schreiben Sie eine E-Mail an lotty@ayrshare.com.
Senden Sie nur die Felder, die Sie ändern möchten. Mindestens eines ist erforderlich, und das Senden eines Feldes, das dieser Endpunkt nicht kennt, führt zur Ablehnung der gesamten Anfrage. Um ein Feld zu leeren, senden Sie es als leeren String: {"description": ""} entfernt die Beschreibung, und das Feld erscheint anschließend überhaupt nicht mehr im Profil. Das funktioniert für description, address und email. Es funktioniert nicht für about, das laut WhatsApp mindestens ein Zeichen enthalten muss — um dieses Feld zu ändern, überschreiben Sie es. Auch vertical kann nicht geleert werden, sobald es einmal gesetzt wurde. Die Antwortfelder messaging_product und profile_picture_url (siehe WhatsApp-Business-Profil) sind schreibgeschützt: Wird eines von beiden zurückgesendet, wird es als unbekanntes Feld abgelehnt. Verwenden Sie profilePictureUrl, um das Foto festzulegen.
string
Text, der unter dem Profilbild angezeigt wird. 1–139 Zeichen. Dies ist das eine Textfeld, das WhatsApp nicht leeren lässt — überschreiben Sie es stattdessen.
string
Unternehmensbeschreibung. Bis zu 512 Zeichen. Senden Sie "", um das Feld zu leeren.
string
Geschäftsadresse. Bis zu 256 Zeichen. Senden Sie "", um das Feld zu leeren.
string
Kontakt-E-Mail-Adresse. Bis zu 128 Zeichen; muss eine gültige Adresse sein, sofern Sie nicht "" senden, um das Feld zu leeren.
array
Ein nicht leeres Array mit bis zu 2 URLs, die jeweils mit http:// oder https:// beginnen.
string
Unternehmenskategorie. WhatsApp akzeptiert derzeit: OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS, MATRIMONY_SERVICE. Diese Liste stammt von WhatsApp und kann mit der Zeit wachsen — Ayrshare schränkt den Wert nicht ein, sodass jede von WhatsApp akzeptierte Kategorie funktioniert. Der Wert wird in Großbuchstaben normalisiert, ein als retail gesendeter Wert wird also als RETAIL zurückgegeben. WhatsApp erlaubt nicht, die Kategorie zu leeren, sobald sie einmal gesetzt wurde, und lehnt einen nicht akzeptierten Wert ab — die Ablehnung wird als 101 mit WhatsApps eigener Meldung zurückgegeben, welche die derzeit akzeptierten Werte benennt.
string
Öffentlich erreichbares JPEG oder PNG, maximal 5 MB. Das Bild muss quadratisch und mindestens 192×192 groß sein — empfohlen sind 640×640. Es gibt keine maximale Auflösung: Ein größeres Bild wird akzeptiert und von WhatsApp herunterskaliert. Ein Bild, das nicht quadratisch ist oder unter 192×192 liegt, wird mit einem 400 abgelehnt, der das Problem benennt, bevor etwas an WhatsApp gesendet wird. Die vollständigen Anforderungen finden Sie in den WhatsApp-Medienrichtlinien.