Trasferire sedi

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

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

Inizia

Per trasferire le sedi sono necessari i seguenti elementi:

Account sorgente:l'account sorgente è quello proprietario della sede. Questo account può essere un account personale o un gruppo di sedi. Una volta completato il trasferimento, l'account di origine non ha più accesso alla località.
Account di destinazione: l'account di destinazione è l'account in cui deve essere trasferita la sede. Può essere un account personale o un gruppo di sedi. Una volta completato il trasferimento, l'account di destinazione è il proprietario principale della sede.
Token di aggiornamento/accesso OAuth2: i token di aggiornamento/accesso OAuth2 per gli account di origine e di destinazione sono necessari per ogni account al fine di chiamare l'API.

Trasferisci le località

Nota: i profili delle attività prevedono un periodo di prova per gli amministratori delle sedi. Dopo essere stato aggiunto a un profilo come proprietario o gestore, l'utente avrà un limite di 7 giorni per le operazioni che può eseguire sugli utenti dell'altra sede e sulla sede stessa. Durante questo periodo, gli utenti che si trovano nel periodo di prova non saranno in grado di trasferire la proprietà principale di un profilo a se stessi o a un terzo utente.

Per trasferire le sedi:

1. Se non sei un proprietario della sede, devi diventarlo. Utilizza le credenziali OAuth dell'attuale proprietario dell'attività per chiamare account.admins.create e invitare un utente ad assumere la proprietà della scheda. Quindi, utilizza le credenziali OAuth dell'utente invitato per chiamare accounts.invitations.list e ottenere l'ID invito. Chiama il numero accounts.invitations.accept per accettare l'invito.

   Nota: il destinatario non può essere un 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. Individua nell'elenco l'ID account in cui vuoi trasferire la sede. L'ID amministratore nella risposta alla chiamata account.admins.create o 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 al passaggio 2 come account di destinazione. Questo è il campo destinationAccount nel corpo della richiesta, che puoi utilizzare per chiamare locations.transfer.

   Nota: una volta completato il trasferimento, l'account di destinazione sarà l'account principale associato al proprietario della scheda. Se questo non è il risultato previsto, ripeti i passaggi 1-3 con un nuovo utente. Poi, trasferisci di nuovo la sede all'account principale originale. Puoi utilizzare l'endpoint accounts.admins.patch 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 località trasferita venga visualizzata nei risultati. Se chiami l'endpoint accounts.locations.list con l'account di origine, la località trasferita non è inclusa nei risultati.

Trasferisci a un gruppo di sedi

Per trasferire una sede a un location group dell'organizzazione, chiama locations.admins.create utilizzando le credenziali OAuth di merchant. Usa il campo account nella risorsa Admin per passare location group account ID insieme all'role appropriato. Devi utilizzare le credenziali amministrative di location group per chiamare accounts.invitations.list utilizzando l'ID account del gruppo di sedi come argomento parent per recuperare gli inviti relativi a location group. Individua l'invito con la località di destinazione corretta e chiama il numero accounts.invitations.accept per accettare l'invito.