Crea un URL di connessione OAuth per una sede

Restituisce un URL OAuth di una piattaforma di pubblicazione limitato a una sede. Indirizza l'utente finale a url; al termine, la piattaforma di pubblicazione lo reindirizza al tuo successUrl (o errorUrl) e le credenziali risultanti vengono associate alla sede come account connesso.

Questo è l'equivalente per una singola sede dei flussi in blocco, Connetti account Google in blocco e Connetti account Facebook in blocco, che creano un link valido per l'intero account e poi si basano sulla corrispondenza per associare le schede. Usa questo endpoint quando sai già quale sede sta connettendo l'utente e vuoi che torni alla pagina di quella sede nel tuo prodotto.

Entrambi gli URL di reindirizzamento sono obbligatori e devono essere assoluti; un valore relativo o non interpretabile viene restituito come success: true con un null url, quindi controlla url e non solo success. Il link è monouso e legato alla sede che hai indicato, quindi creane uno nuovo per ogni tentativo anziché memorizzarlo nella cache.

Caso d'uso: connettere un negozio dalla tua app

Quando un utente connette un negozio dalla tua app, invia una richiesta POST a questo endpoint con l'ID della sede, site: "GOOGLE" e gli URL di reindirizzamento che riportano alla tua app. Indirizza l'utente a url in una finestra popup o tramite un reindirizzamento a pagina intera. Quando torna, consulta Ottieni i dettagli dell'account connesso o le informazioni di connessione della sede per confermare che la connessione sia stata stabilita, quindi mostra lo stato connesso nella tua app. Se l'utente abbandona il flusso, viene indirizzato a errorUrl e non viene associato nulla, quindi crea un nuovo link e consentigli di riprovare.

Caso d'uso: pubblicare tramite l'account Apple Business del proprietario

Invia site: "APPLE" per connettere una sede all'account dell'organizzazione verificato su Apple Business del proprietario. Il proprietario apre url, accede a quell'account e concede l'accesso. Da quel momento, ListingsAPI pubblica i dati Apple Maps di quella sede tramite l'account del proprietario.

Se il proprietario non ha un account dell'organizzazione verificato su Apple Business, salta questo flusso. ListingsAPI pubblica la sede tramite il proprio account Apple Business Connect e Apple verifica la richiesta di pubblicazione prima di pubblicare la sede. Ogni sede viene connessa separatamente, quindi uno stesso account può avere sedi di entrambi i tipi.

Dopo che il proprietario torna a successUrl, chiama Elenca gli account connessi con publisher=AppleAccount e verifica che il valore di status dell'account sia CONNECTED. Per il flusso completo, incluse le istruzioni per controllare la scheda su Apple Maps, consulta Connetti Apple Business Connect.

Questo endpoint crea credenziali OAuth reali. La richiesta e la risposta di esempio riportate sopra sono esempi.