v1Ressourcen/Connections/postEintragskonto auf Agenturebene verschieben

Eintragskonto auf Agenturebene verschieben

Verschiebt das Google- oder Facebook-Eintragskonto eines Kunden auf Agenturebene, sodass seine Einträge Standorten jedes Kunden Ihrer Agentur zugewiesen werden können. Nichts wird neu verbunden und niemand muss sich erneut anmelden: Die Standorte, die das Konto bereits bedient, bleiben über dieselbe Anmeldung verbunden. Hat Ihre Agentur bereits ein Konto auf Agenturebene für dieselbe Google- oder Facebook-Anmeldung, wird dieses Konto damit zusammengeführt. Seine Einträge und Werbekonten wechseln zum bestehenden Konto, und das verschobene Konto wird archiviert. Senden Sie zuerst dryRun mit true, um zu sehen, was passieren würde, ohne etwas zu ändern. Dafür ist ein Token mit Zugriff auf alle Kunden nötig; ein auf bestimmte Kunden beschränkter Token erhält 403. Liefert 400 für alles außer einem Google- oder Facebook-Eintragskonto (Social-Konten auf Markenebene und die Verbindung eines einzelnen Standorts lassen sich nicht verschieben), 404, wenn die Verbindung nicht existiert oder archiviert ist, und 409, wenn das Konto bereits auf Agenturebene liegt.

post/api/v1/connections/move-to-agency
connections:write
Anfragetext
connectionIdstringerforderlich
Die ID des zu verschiebenden Eintragskontos. Verwenden Sie die Verbindung des Kontos selbst, nicht die Verbindung eines seiner Standorte.
dryRunbooleanoptional
Auf true setzen, um die Verschiebung nur in der Vorschau zu sehen, ohne sie auszuführen. Die Antwort enthält dieselben Felder, ohne moved.
Antwort
dataobjectoptional
movedboolean (true)optional
Nach einer echten Verschiebung immer true. Bei einem Probelauf nicht enthalten.
accountIdstringoptional
Das Konto, dessen Verschiebung Sie angefordert haben. Nach einer Zusammenführung ist dieses Konto archiviert, und ab dann ist mergeIntoId das zu verwendende Konto.
mergeIntoIdstringoptional
Das bestehende Konto auf Agenturebene, mit dem dieses Konto zusammengeführt wird, oder null, wenn das Konto für sich allein verschoben wird.
mergeIntoNamestringoptional
Der Anzeigename des Kontos, mit dem es zusammengeführt wird, oder null, wenn keine Zusammenführung erfolgt.
locationCountintegeroptional
Wie viele verbundene Standorte das Konto bedient, gezählt vor der Verschiebung.
clientCountintegeroptional
Zu wie vielen Kunden diese Standorte gehören.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/connections/move-to-agency
Ihr API-Schlüssel
Anfragetext*
{}

Anleitungen, die diese Ressource verwenden