Crear cuentas

Puedes usar la API de Merchant para crear cuentas de Merchant Center, que se pueden vincular a una cuenta avanzada con accountAggregation, accountManagement o comparisonShopping. El accounts.createAndConfigure método te permite crear una cuenta y, de manera opcional, configurarla con usuarios y vincularla a otras cuentas a través de servicios.

En esta guía, se explica cómo usar la API de Merchant para crear cuentas con servicios como accountManagement, comparisonShopping o accountAggregation. Cuando usas accounts.createAndConfigure, debes vincular la cuenta nueva a un proveedor especificando al menos uno de los siguientes valores en el campo service: accountAggregation, accountManagement o comparisonShopping. Puedes especificar accountAggregation y comparisonShopping en la misma solicitud, pero accountManagement no se puede combinar con accountAggregation ni comparisonShopping. Si especificas accountManagement, también debes agregar al menos un usuario a la cuenta nueva con el campo user o users.

Requisitos previos

Antes de crear cuentas con la API de Merchant, asegúrate de cumplir con los siguientes requisitos según los servicios que uses:

  • Acceso de administrador: Debes tener acceso de administrador a la cuenta del proveedor cuando vinculas una cuenta nueva con accountManagement, comparisonShopping, o accountAggregation.
  • Cuenta avanzada: Si usas accountAggregation, tu cuenta de proveedor debe ser una cuenta avanzada configurada para la agregación de cuentas. Si eres un proveedor de servicios y necesitas configurar una cuenta avanzada, comunícate con el equipo de asistencia para obtener ayuda con la configuración.

Crea una cuenta (con administración de cuentas o comparación de productos)

Para crear una cuenta nueva, llama a accounts.createAndConfigure. Este es el enfoque recomendado para los socios que ayudan a los comerciantes a administrar sus cuentas, ya que les permite conservar el control total y la propiedad de su cuenta, al mismo tiempo que otorgan permisos específicos a los socios.

En el cuerpo de la solicitud, haz lo siguiente:

  1. Proporciona los detalles de la cuenta que deseas crear en el account campo.
  2. En el campo accountName, no uses signos de puntuación, mayúsculas, guiones bajos, letras mayúsculas, emojis ni símbolos no alfanuméricos innecesarios o repetidos, como / o _. Evita usar sufijos comerciales (como "Inc." o "GmbH"), texto promocional, información personal o lenguaje inapropiado. Usa un nombre corto, claro y profesional. Para obtener más información, consulta cómo agregar el nombre de una empresa.
  3. Si usas accountManagement, especifica al menos un usuario en el user campo que tendrá acceso a la cuenta.
  4. En el service campo, especifica los servicios que deseas proporcionar a esta cuenta, por ejemplo, accountManagement, y establece provider en el nombre de recurso de tu cuenta (por ejemplo, providers/{YOUR_ACCOUNT_ID}). Para obtener una lista de los servicios disponibles, como productsManagement o campaignsManagement, consulta Administra las relaciones de las cuentas.

A continuación, se muestra una solicitud de ejemplo para crear una cuenta llamada "merchantStore" y vincularla a la cuenta {YOUR_ACCOUNT_ID} para la administración de cuentas y productos:

POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure

{
  "account": {
    "accountName": "merchantStore",
    "adultContent": false,
    "timeZone": {
      "id": "America/New_York"
    },
    "languageCode": "en-US"
  },
  "user": [
    {
      "userId": "test@example.com",
      "user": {
        "accessRights": ["ADMIN"]
      }
    }
  ],
  "service": [
    {
      "accountManagement": {},
      "provider": "providers/{YOUR_ACCOUNT_ID}"
    },
    {
      "productsManagement": {},
      "provider": "providers/{YOUR_ACCOUNT_ID}"
    }
  ]
}

Una llamada correcta crea la cuenta nueva y la vincula a tu cuenta para los servicios especificados. Si especificas los servicios accountManagement, accountAggregation o comparisonShopping durante la creación, se aprueban automáticamente y el estado del vínculo es ESTABLISHED. Es posible que otros vínculos de servicio estén en estado PENDING hasta que la cuenta creada los acepte. El cuerpo de la respuesta contiene el recurso Account recién creado.

Después de crear una cuenta de este tipo, debes incorporarla. Para ello, sigue pasos tales como aceptar las Condiciones del Servicio, configurar la información de la empresa, y verificar el sitio web.

Suprime la verificación por correo electrónico durante la creación de la cuenta

Cuando creas una cuenta con accounts.createAndConfigure, puedes suprimir de forma opcional los correos electrónicos de verificación para los usuarios nuevos que se agregaron con el campo user. Para ello, establece verificationMailSettings.verificationMailMode en SUPPRESS_VERIFICATION_MAIL en la solicitud de ese usuario. Esto es útil si deseas verificar a los usuarios en nombre del comerciante inmediatamente después de la creación con el método.users.verifySelf De forma predeterminada, verificationMailMode es SEND_VERIFICATION_MAIL, y los correos electrónicos de verificación se envían a los usuarios nuevos que se agregaron durante la creación de la cuenta.

POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure

{
  "account": {
    "accountName": "merchantStore",
    "adultContent": false,
    "timeZone": {
      "id": "America/New_York"
    },
    "languageCode": "en-US"
  },
  "user": [
    {
      "userId": "test@example.com",
      "user": {
        "accessRights": ["ADMIN"]
      },
      "verificationMailSettings": {
        "verificationMailMode": "SUPPRESS_VERIFICATION_MAIL"
      }
    }
  ],
  "service": [
    {
      "accountManagement": {},
      "provider": "providers/{YOUR_ACCOUNT_ID}"
    }
  ]
}

Si estableces verificationMailMode en SUPPRESS_VERIFICATION_MAIL, debes llamar a users.verifySelf para cada usuario que se agregó durante la creación para completar la verificación. Esta llamada debe autenticarse como el usuario que se está verificando (el usuario especificado en userId), por ejemplo, con un token de OAuth del usuario.

Especifica un alias durante la creación de la cuenta

Puedes especificar un alias para una cuenta en el contexto de un proveedor en CreateAndConfigureAccountRequest con el campo setAlias. El alias se puede usar para identificar la cuenta en tu sistema. Si eres un proveedor de servicios, puedes usar el alias para recuperar la cuenta con GET /accounts/v1/accounts/{provider}~{alias}. El alias debe ser único para un proveedor determinado, y debes especificar un servicio con el mismo proveedor en el campo service de la solicitud. Para obtener más información sobre los requisitos de alias, consulta Administra las relaciones de las cuentas.

POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure

{
  "account": {
    "accountName": "merchantStore",
    "adultContent": false,
    "timeZone": {
      "id": "America/New_York"
    },
    "languageCode": "en-US"
  },
  "service": [
    {
      "accountManagement": {},
      "provider": "providers/{YOUR_ACCOUNT_ID}"
    }
  ],
  "setAlias": [
    {
      "provider": "providers/{YOUR_ACCOUNT_ID}",
      "accountIdAlias": "my-merchant-alias"
    }
  ]
}

Si eres un socio que crea una cuenta en nombre de un comerciante, te recomendamos el siguiente flujo:

  1. Crea una cuenta: Llama a accounts.createAndConfigure con tus credenciales de socio para crear una cuenta nueva.
    • Establece service para incluir accountManagement que se vincula a tu ID de proveedor.
    • Agrega al comerciante como usuario con el campo user y establece verificationMailSettings.verificationMailMode en SUPPRESS_VERIFICATION_MAIL.
  2. Verifica al usuario: Con las credenciales del comerciante (por ejemplo, con un token de OAuth), llama a users.verifySelf para cambiar el estado del usuario de PENDING a VERIFIED.
  3. Establece el país de la empresa: Con las credenciales del comerciante, establece el país de la empresa actualizando address.regionCode con accounts.updateBusinessInfo. Esto es obligatorio antes de aceptar las Condiciones del Servicio.
  4. Acepta las Condiciones del Servicio: Con las credenciales del comerciante, acepta las Condiciones del Servicio.

Este flujo permite que un comerciante se incorpore sin problemas a tu plataforma sin recibir correos electrónicos de invitación de Google.

Crea una cuenta de cliente (con agregación de cuentas)

Las cuentas de cliente son cuentas de Merchant Center distintas vinculadas a tu cuenta avanzada con el servicio accountAggregation, lo que permite una administración centralizada y, al mismo tiempo, mantiene la configuración, los sitios web y los feeds de datos separados. Puedes usar la sub-API de cuentas de Merchant para crear cuentas de cliente nuevas.

Para crear cuentas de cliente, primero debes tener una configuración de cuenta avanzada. Debes ser administrador de la cuenta para convertir tu cuenta de Merchant Center en una cuenta avanzada, y tu cuenta no debe tener problemas pendientes.

Para crear una cuenta de cliente nueva, llama a accounts.createAndConfigure. En el cuerpo de la solicitud, haz lo siguiente:

  1. Proporciona los detalles de la cuenta que deseas crear en el account campo.
  2. En el campo accountName, no uses signos de puntuación, mayúsculas, guiones bajos ni símbolos no alfanuméricos innecesarios o repetidos, como "/" o "_". Evita usar sufijos comerciales (como "Inc." o "GmbH"), texto promocional, información personal o lenguaje inapropiado. Usa un nombre corto, claro y profesional. Para obtener más información, consulta cómo agregar el nombre de una empresa.
  3. De manera opcional, especifica los usuarios autorizados nuevos en el user campo. El acceso de usuario a la cuenta también se hereda de la cuenta avanzada superior.
  4. En el service campo, especifica accountAggregation y establece el provider en el nombre de recurso de tu cuenta avanzada (por ejemplo, providers/{ADVANCED_ACCOUNT_ID}). Esto establece tu cuenta avanzada como el agregador de la cuenta nueva.

A continuación, se muestra una solicitud de ejemplo para crear una cuenta de cliente llamada "merchantStore" vinculada a la cuenta avanzada {ADVANCED_ACCOUNT_ID}:

POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure

{
  "account": {
    "accountName": "merchantStore",
    "adultContent": false,
    "timeZone": {
      "id": "America/New_York"
    },
    "languageCode": "en-US"
  },
  "service": [
    {
      "accountAggregation": {},
      "provider": "providers/{ADVANCED_ACCOUNT_ID}"
    }
  ]
}

Una llamada correcta crea la cuenta de cliente nueva y la vincula a la cuenta avanzada especificada. El cuerpo de la respuesta contendrá el recurso recién creado Account.

En los siguientes ejemplos, se muestra cómo puedes usar accounts.createAndConfigure para crear una cuenta de cliente nueva.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.Account;
import com.google.shopping.merchant.accounts.v1.AccountAggregation;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest;
import com.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest.AddAccountService;
import com.google.type.TimeZone;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to create a sub-account under an advanced account. */
public class CreateSubAccountSample {

  private static String getParent(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void createSubAccount(Config config) throws Exception {

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

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent/provider to identify the advanced account into which to insert the subaccount.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      CreateAndConfigureAccountRequest request =
          CreateAndConfigureAccountRequest.newBuilder()
              .setAccount(
                  Account.newBuilder()
                      .setAccountName("Demo Business")
                      .setAdultContent(false)
                      .setTimeZone(TimeZone.newBuilder().setId("America/New_York").build())
                      .setLanguageCode("en-US")
                      .build())
              .addService(
                  AddAccountService.newBuilder()
                      .setProvider(parent)
                      .setAccountAggregation(AccountAggregation.getDefaultInstance())
                      .build())
              .build();

      System.out.println("Sending Create SubAccount request");
      Account response = accountsServiceClient.createAndConfigureAccount(request);
      System.out.println("Inserted Account Name below");
      // Format: `accounts/{account}
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

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

    createSubAccount(config);
  }
}

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Account;
use Google\Shopping\Merchant\Accounts\V1\AccountAggregation;
use Google\Shopping\Merchant\Accounts\V1\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\CreateAndConfigureAccountRequest;
use Google\Shopping\Merchant\Accounts\V1\CreateAndConfigureAccountRequest\AddAccountService;
use Google\Type\TimeZone;

/**
 * This class demonstrates how to create a sub-account under an MCA account.
 */
class CreateSubAccount
{

    private static function getParent(string $accountId): string
    {
        return sprintf("accounts/%s", $accountId);
    }


    public static function createSubAccount(array $config): void
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $accountsServiceClient = new AccountsServiceClient($options);

        // Creates parent/provider to identify the MCA account into which to insert the subaccount.
        $parent = self::getParent($config['accountId']);

        // Calls the API and catches and prints any network failures/errors.
        try {
            $request = new CreateAndConfigureAccountRequest([
                'account' => (new Account([
                    'account_name' => 'Demo Business',
                    'adult_content' => false,
                    'time_zone' => (new TimeZone(['id' => 'America/New_York'])),
                    'language_code' => 'en-US',
                ])),
                'service' => [
                    (new AddAccountService([
                        'provider' => $parent,
                        'account_aggregation' => new AccountAggregation,
                    ])),
                ],
            ]);

            print "Sending Create SubAccount request\n";
            $response = $accountsServiceClient->createAndConfigureAccount($request);
            print "Inserted Account Name below\n";
            // Format: `accounts/{account}
            print $response->getName() . PHP_EOL;
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }
    public function callSample(): void
    {
        $config = Config::generateConfig();
        self::createSubAccount($config);
    }
}

$sample = new CreateSubAccount();
$sample->callSample();

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import Account
from google.shopping.merchant_accounts_v1 import AccountAggregation
from google.shopping.merchant_accounts_v1 import AccountsServiceClient
from google.shopping.merchant_accounts_v1 import CreateAndConfigureAccountRequest

_ACCOUNT = configuration.Configuration().read_merchant_info()


def get_parent(account_id):
  return f"accounts/{account_id}"


def create_sub_account():
  """Creates a sub-account under an advanced account."""

  # Get OAuth credentials.
  credentials = generate_user_credentials.main()

  # Create a client.
  client = AccountsServiceClient(credentials=credentials)

  # Get the parent advanced account ID.
  parent = get_parent(_ACCOUNT)

  # Create the request.
  request = CreateAndConfigureAccountRequest(
      account=Account(
          account_name="Demo Business",
          adult_content=False,
          time_zone={"id": "America/New_York"},
          language_code="en-US",
      ),
      service=[
          CreateAndConfigureAccountRequest.AddAccountService(
              provider=parent,
              account_aggregation=AccountAggregation(),
          )
      ],
  )

  # Make the request and print the response.
  try:
    print("Sending Create SubAccount request")
    response = client.create_and_configure_account(request=request)
    print("Inserted Account Name below")
    print(response.name)
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  create_sub_account()

cURL

curl -X POST \
"https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
  "account": {
    "accountName": "Demo Business",
    "adultContent": false,
    "timeZone": {
      "id": "America/New_York"
    },
    "languageCode": "en-US"
  },
  "service": [
    {
      "accountAggregation": {},
      "provider": "providers/{ADVANCED_ACCOUNT_ID}"
    }
  ]
}'

Recupera cuentas de cliente

Para enumerar todas las cuentas de cliente de una cuenta avanzada determinada, usa el accounts.listSubaccounts método. Proporciona el ID de tu cuenta avanzada en el campo provider de la URL de la solicitud.

A continuación, se muestra una solicitud de ejemplo:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ADVANCED_ACCOUNT_ID}:listSubaccounts

Esta es una respuesta de ejemplo de una llamada correcta:

{
"accounts": [
    {
      "name": "accounts/<var class=\"readonly\">{SUB_ACCOUNT_ID_1}</var>",
      "accountId": "<var class=\"readonly\">{SUB_ACCOUNT_ID_1}</var>",
      "accountName": "<var class=\"readonly\">{SUB_ACCOUNT_NAME_1}</var>",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    },
    {
      "name": "accounts/<var class=\"readonly\">{SUB_ACCOUNT_ID_2}</var>",
      "accountId": "<var class=\"readonly\">{SUB_ACCOUNT_ID_2}</var>",
      "accountName": "<var class=\"readonly\">{SUB_ACCOUNT_NAME_2}</var>",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

En los siguientes ejemplos, se muestra cómo enumerar todas las cuentas de cliente de tu cuenta avanzada.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.Account;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient.ListSubAccountsPagedResponse;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.ListSubAccountsRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to list all the subaccounts of an advanced account. */
public class ListSubAccountsSample {

  private static String getParent(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void listSubAccounts(Config config) throws Exception {

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

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent/provider to identify the advanced account from which to list all sub-accounts.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      // The parent has the format: accounts/{account}
      ListSubAccountsRequest request =
          ListSubAccountsRequest.newBuilder().setProvider(parent).build();
      System.out.println("Sending list subaccounts request:");

      ListSubAccountsPagedResponse response = accountsServiceClient.listSubAccounts(request);

      int count = 0;

      // Iterates over all rows in all pages and prints the datasource in each row.
      // Automatically uses the `nextPageToken` if returned to fetch all pages of data.
      for (Account account : response.iterateAll()) {
        System.out.println(account);
        count++;
      }
      System.out.print("The following count of accounts were returned: ");
      System.out.println(count);
    } catch (Exception e) {
      System.out.println("An error has occured: ");
      System.out.println(e);
    }
  }

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

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\ListSubAccountsRequest;

/**
 * This class demonstrates how to list all the subaccounts of an advanced account.
 */
class ListSubAccounts
{
    private static function getParent(string $accountId): string
    {
        return sprintf("accounts/%s", $accountId);
    }


    public static function listSubAccounts(array $config): void
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $accountsServiceClient = new AccountsServiceClient($options);

        // Creates parent/provider to identify the advanced account from which
        //to list all accounts.
        $parent = self::getParent($config['accountId']);

        // Calls the API and catches and prints any network failures/errors.
        try {

            // The parent has the format: accounts/{account}
            $request = new ListSubAccountsRequest(['provider' => $parent]);
            print "Sending list subaccounts request:\n";

            $response = $accountsServiceClient->listSubAccounts($request);

            $count = 0;

            // Iterates over all rows in all pages and prints the datasource in each row.
            // Automatically uses the `nextPageToken` if returned to fetch all pages of data.
            foreach ($response->iterateAllElements() as $account) {
                print_r($account);
                $count++;
            }
            print "The following count of accounts were returned: ";
            print $count . PHP_EOL;
        } catch (ApiException $e) {
            print "An error has occured: \n";
            print $e->getMessage();
        }
    }

    public function callSample(): void
    {
        $config = Config::generateConfig();
        self::listSubAccounts($config);
    }
}

$sample = new ListSubAccounts();
$sample->callSample();

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AccountsServiceClient
from google.shopping.merchant_accounts_v1 import ListSubAccountsRequest

_ACCOUNT = configuration.Configuration().read_merchant_info()


def get_parent(account_id):
  return f"accounts/{account_id}"


def list_sub_accounts():
  """Lists all the subaccounts of an advanced account."""

  # Get OAuth credentials.
  credentials = generate_user_credentials.main()

  # Create a client.
  client = AccountsServiceClient(credentials=credentials)

  # Get the parent advanced account ID.
  parent = get_parent(_ACCOUNT)

  # Create the request.
  request = ListSubAccountsRequest(provider=parent)

  # Make the request and print the response.
  try:
    print("Sending list subaccounts request:")
    response = client.list_sub_accounts(request=request)

    count = 0
    for account in response:
      print(account)
      count += 1

    print(f"The following count of accounts were returned: {count}")

  except RuntimeError as e:
    print("An error has occured: ")
    print(e)


if __name__ == "__main__":
  list_sub_accounts()

cURL

curl -X GET \
"https://merchantapi.googleapis.com/accounts/v1/accounts/{ADVANCED_ACCOUNT_ID}:listSubaccounts" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}" \

Borra una cuenta de cliente

Si ya no necesitas administrar una cuenta de cliente, puedes borrarla con el accounts.delete método.

Para ejecutar este método, se requiere acceso de administrador a la cuenta que se borrará.

A continuación, se muestra una solicitud de ejemplo:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{SUB_ACCOUNT_ID}

Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío, lo que indica que se borró la cuenta.

En los siguientes ejemplos, se muestra cómo borrar una cuenta de cliente.

Java

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.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.DeleteAccountRequest;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to delete a given Merchant Center account. */
public class DeleteAccountSample {

  // This method can delete a standalone, advanced account or sub-account. If you delete an advanced
  // account,
  // all sub-accounts will also be deleted.
  // Admin user access is required to execute this method.

  public static void deleteAccount(Config config) throws Exception {

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

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Gets the account ID from the config file.
    String accountId = config.getAccountId().toString();

    // Creates account name to identify the account.
    String name =
        AccountName.newBuilder()
            .setAccount(accountId)
            .build()
            .toString();

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {
      DeleteAccountRequest request =
          DeleteAccountRequest.newBuilder()
              .setName(name)
              // Optional. If set to true, the account will be deleted even if it has offers or
              // provides services to other accounts. Defaults to 'false'.
              .setForce(true)
              .build();

      System.out.println("Sending Delete Account request");
      accountsServiceClient.deleteAccount(request); // No response returned on success.
      System.out.println("Delete successful.");
    } catch (Exception e) {
      System.out.println(e);
    }
  }

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

PHP

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\DeleteAccountRequest;


/**
 * This class demonstrates how to delete a given Merchant Center account.
 */
class DeleteAccount
{
    private static function getParent(string $accountId): string
    {
        return sprintf("accounts/%s", $accountId);
    }

    // This method can delete a standalone, advanced account or sub-account.
    // If you delete an advanced account, all sub-accounts will also be deleted.
    // Admin user access is required to execute this method.
    public static function deleteAccount(array $config): void
    {
        // Gets the OAuth credentials to make the request.
        $credentials = Authentication::useServiceAccountOrTokenFile();

        // Creates options config containing credentials for the client to use.
        $options = ['credentials' => $credentials];

        // Creates a client.
        $accountsServiceClient = new AccountsServiceClient($options);


        // Gets the account ID from the config file.
        $accountId = $config['accountId'];

        // Creates account name to identify the account.
        $name = self::getParent($accountId);

        // Calls the API and catches and prints any network failures/errors.
        try {
            $request = new DeleteAccountRequest([
                'name' => $name,
                // Optional. If set to true, the account will be deleted even if it has offers or
                // provides services to other accounts. Defaults to 'false'.
                'force' => true,
            ]);

            print "Sending Delete Account request\n";
            $accountsServiceClient->deleteAccount($request); // No response returned on success.
            print "Delete successful.\n";
        } catch (ApiException $e) {
            print $e->getMessage();
        }
    }

    public function callSample(): void
    {
        $config = Config::generateConfig();
        self::deleteAccount($config);
    }
}

$sample = new DeleteAccount();
$sample->callSample();

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import AccountsServiceClient
from google.shopping.merchant_accounts_v1 import DeleteAccountRequest

_ACCOUNT = configuration.Configuration().read_merchant_info()


def get_parent(account_id):
  return f"accounts/{account_id}"


def delete_account():
  """Deletes a given Merchant Center account."""

  # Get OAuth credentials.
  credentials = generate_user_credentials.main()

  # Create a client.
  client = AccountsServiceClient(credentials=credentials)

  # Create the account name.
  name = get_parent(_ACCOUNT)

  # Create the request.
  request = DeleteAccountRequest(name=name, force=True)

  # Make the request and print the response.
  try:
    print("Sending Delete Account request")
    client.delete_account(request=request)
    print("Delete successful.")
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  delete_account()

cURL

curl -X DELETE \
"https://merchantapi.googleapis.com/accounts/v1/accounts/{SUB_ACCOUNT_ID}?force=true" \
-H "Authorization: Bearer {YOUR_ACCESS_TOKEN}" \

Acepta las Condiciones del Servicio

Las cuentas de cliente heredan las Condiciones del Servicio (CdS) de Merchant Center que firmó la cuenta avanzada superior.

Actualiza la información de la empresa

Puedes usar la sub-API de cuentas para editar la información de la empresa para tus cuentas de cliente.