Collegare un profilo dell'attività su Google

Un gruppo di attività Google è come una cartella condivisa per le tue sedi. Un gruppo di sedi offre un metodo sicuro per condividere con più utenti la gestione delle sedi. Per ulteriori informazioni, vedi Informazioni sui gruppi di sedi.

Prima di caricare l'inventario locale, specifica il gruppo di sedi di cui sarà responsabile il tuo account Merchant Center. Puoi ottenere l'elenco dei gruppi di sedi idonei dal profilo dell'attività utilizzando l'API Merchant, ma per ottenere l'accesso devi prima collegare il tuo account a un profilo dell'attività.

Richiedere l'accesso a un profilo dell'attività

Per accedere a un profilo dell'attività, utilizza il metodo gbpAccounts.LinkGbpAccount:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/<var>ACCOUNT_ID</var>/gbpAccounts:linkGbpAccount

{
  "gbpEmail": "admin@example.com",
}

Sostituisci quanto segue:

  • ACCOUNT_ID: l'identificatore univoco del tuo account Merchant Center
  • GBP_EMAIL: l'indirizzo email dell'amministratore del profilo dell'attività

Quando viene chiamato questo metodo, il servizio invia un'email all'amministratore specificato, chiedendo di accettare o rifiutare la richiesta di accesso. Se l'amministratore non risponde entro 7 giorni, la richiesta scade automaticamente.

Elenca i gruppi di sedi disponibili

Una volta che l'amministratore ha approvato la richiesta, puoi controllare i gruppi di attività disponibili utilizzando il metodo gbpAccounts.List.

Ecco un esempio di richiesta e risposta corretta:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/<var>ACCOUNT_ID</var>/gbpAccounts

Response:
200 OK
{
  "gbpAccounts": [
    {
      "name": "accounts/<var>ACCOUNT</var>/gbpAccounts/12345",
      "gbpAccountId": 12345,
      "type": USER,
      "gbpAccountName": "admin@example.com",
      "listingCount": 15
    }, {
      "name": "accounts/<var>ACCOUNT</var>/gbpAccounts/67890",
      "gbpAccountId": 67890,
      "type": BUSINESS_ACCOUNT,
      "gbpAccountName": "Google My Business Account",
      "listingCount": 23
    }
  ],
  "nextPageToken": 50
}

Puoi utilizzare questo codice di esempio per recuperare tutti i gruppi di attività idonei:

package shopping.merchant.samples.accounts.v1;

// [START merchantapi_list_gbp_accounts]
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.AccountName;
import com.google.shopping.merchant.accounts.v1.GbpAccount;
import com.google.shopping.merchant.accounts.v1.GbpAccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.GbpAccountsServiceClient.ListGbpAccountsPagedResponse;
import com.google.shopping.merchant.accounts.v1.GbpAccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.ListGbpAccountsRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 *   This class demonstrates how to get the list of GBP accounts for a given Merchant Center account
 */
public class ListGbpAccountsSample {

  public static void listGbpAccounts(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the retrieved credentials.
    GbpAccountsServiceSettings gbpAccountsServiceSettings =
        GbpAccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    String accountId = config.getAccountId().toString();
    // Creates parent to identify the omnichannelSetting from which to list all Lfp Providers.
    String parent = AccountName.newBuilder().setAccount(accountId).build().toString();

    // Calls the API and catches and prints any network failures/errors.
    try (GbpAccountsServiceClient gbpAccountsServiceClient =
        GbpAccountsServiceClient.create(gbpAccountsServiceSettings)) {
      ListGbpAccountsRequest request =
          ListGbpAccountsRequest.newBuilder().setParent(parent).build();

      System.out.println("Sending list GBP accounts request:");
      ListGbpAccountsPagedResponse response = gbpAccountsServiceClient.listGbpAccounts(request);

      int count = 0;

      // Iterates over all the entries in the response.
      for (GbpAccount gbpAccount : response.iterateAll()) {
        System.out.println(gbpAccount);
        count++;
      }
      System.out.println(String.format("The following count of elements were returned: %d", count));
    } catch (Exception e) {
      System.out.println("An error has occurred: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    listGbpAccounts(config);
  }
}
// [END merchantapi_list_gbp_accounts]

Specifica il gruppo di sedi per l'account Merchant Center

di gruppi di sedi disponibili, puoi associare il gruppo di sedi al tuo account Merchant Center. Ad esempio, se vuoi scegliere il gruppo di attività con l'ID account GBP 12345 (restituito dal passaggio precedente), puoi utilizzare AccountServices.proposeAccountService:

POST
https://merchantapi.googleapis.com/accounts/v1/accounts/<var>ACCOUNT_ID</var>/services:propose
{
  provider: "providers/GOOGLE_BUSINESS_PROFILE",
  account_service: {
    external_account_id: "12345",
    local_listing_management {}
  }
}

Tieni presente che il campo provider deve essere providers/GOOGLE_BUSINESS_PROFILE. Devi impostare un campo LocalListingManagement vuoto nella richiesta.

Inviare i dati di prodotto e di inventario

Ora che hai associato il tuo account Merchant Center a un gruppo di sedi, puoi caricare i dati di inventario locale e dei prodotti. Per ulteriori informazioni, vedi