Trasferire sedi

Con l'API My Business Account Management puoi trasferire le sedi a diversi account o gruppi di località. Segui le istruzioni riportate in questa documentazione per scoprire come fare.

Nota: per trasferire una sede, il chiamante deve essere un proprietario della sede e il titolare dell'account di destinazione deve essere almeno un gestore della sede. Per maggiori dettagli su come concedere la proprietà di una scheda, consulta Gestire gli amministratori per account e sedi.

Inizia

Per trasferire le sedi sono necessari i seguenti elementi:

Account di origine: l'account di origine è l'account proprietario della sede. Questo account può essere un account personale o un gruppo di sedi. Al termine del trasferimento, l'account di origine non ha più accesso alla sede.
Account di destinazione: l'account di destinazione è l'account a cui deve essere trasferita la sede. Questo account può essere un account personale o un gruppo di sedi. Al termine del trasferimento, l'account di destinazione è il proprietario principale della sede.
Token di accesso/aggiornamento OAuth2: per chiamare l'API sono necessari i token di accesso/aggiornamento OAuth2 per gli account di origine e di destinazione.

Trasferire le sedi

Nota: i profili delle attività hanno un periodo di prova per gli amministratori delle sedi. Una volta che un utente viene aggiunto a un profilo come proprietario o gestore, per un periodo di 7 giorni le operazioni che può eseguire sugli utenti dell'altra sede e sulla sede stessa saranno limitate. Durante questo periodo, gli utenti nel periodo di prova non potranno trasferire la proprietà principale di un profilo a se stessi o a un terzo utente.

Per trasferire le sedi, completa i seguenti passaggi:

1. Se non sei proprietario della sede, devi diventarlo. Utilizza le credenziali OAuth del proprietario dell'attività attuale per chiamare account.admins.create e invitare un utente a diventare proprietario della scheda. Poi, utilizza le credenziali OAuth dell'utente invitato per chiamare accounts.invitations.list per ottenere l'ID dell'invito. Chiama accounts.invitations.accept per accettare questo invito.

   Nota: il destinatario non può essere membro di un account dell'organizzazione o di un gruppo di utenti.

2. Utilizza le credenziali OAuth dell'account di destinazione previsto per chiamare accounts.list. Poi, trova l'ID dell'account nell'elenco a cui vuoi trasferire la sede. L'ID amministratore nella risposta alla chiamata account.admins.create o alla chiamata accounts.invitations.list nel passaggio 1 può essere utilizzato anche come ID account. Questo ID account può fare riferimento a un account personale o a un gruppo di sedi.

3. Utilizza l'ID account recuperato nel passaggio 2 come account di destinazione. Questo è il campo destinationAccount nel corpo della richiesta, che puoi utilizzare per chiamare locations.transfer.

   Nota: al termine del trasferimento, l'account di destinazione è l'account principale associato al proprietario della scheda. Se non è il risultato previsto, ripeti i passaggi da 1 a 3 con un nuovo utente. Poi, trasferisci di nuovo la sede all'account principale originale. Puoi utilizzare l' accounts.admins.patch endpoint per eseguire il downgrade del ruolo di amministratore dell'account di destinazione originale.

Utilizza le credenziali OAuth dell'account di destinazione per chiamare accounts.locations.list e verificare che la sede trasferita venga visualizzata nei risultati. Se chiami l'endpoint accounts.locations.list con l'account di origine, la sede trasferita non è inclusa nei risultati.

Trasferire a un gruppo di sedi

Per trasferire una sede a un location group nell'organizzazione, chiama locations.admins.create utilizzando le credenziali OAuth del merchant. Utilizza il campo account nella risorsa Admin per trasmettere il location group account ID insieme al appropriato role. Devi utilizzare le credenziali di amministratore del location group per chiamare accounts.invitations.list utilizzando l'ID account del gruppo di sedi come argomento parent per recuperare gli inviti relativi al location group. Trova l'invito con la sede di destinazione corretta, quindi chiama accounts.invitations.accept per accettare l'invito corretto.