Создать учетные записи

Вы можете использовать Merchant API для создания учетных записей Merchant Center, которые можно связать с расширенной учетной записью с помощью accountAggregation , accountManagement или comparisonShopping . Метод accounts.createAndConfigure позволяет создать учетную запись и при необходимости настроить ее с помощью пользователей, а также связать ее с другими учетными записями через сервисы.

В этом руководстве объясняется, как использовать Merchant API для создания учетных записей с помощью таких сервисов, как accountManagement , comparisonShopping или accountAggregation . При использовании accounts.createAndConfigure необходимо связать новую учетную запись с поставщиком, указав в поле service хотя бы один из следующих сервисов: accountAggregation , accountManagement или comparisonShopping . Вы можете указать accountAggregation и comparisonShopping в одном запросе, но accountManagement нельзя комбинировать ни с accountAggregation , ни comparisonShopping . Если вы указываете accountManagement , необходимо также добавить хотя бы одного пользователя в новую учетную запись, используя поле user или users .

Предварительные требования

Прежде чем создавать учетные записи с помощью Merchant API, убедитесь, что вы соответствуете следующим требованиям в зависимости от используемых вами сервисов:

  • Доступ администратора : Для привязки новой учетной записи с помощью accountManagement , comparisonShopping или accountAggregation вам необходим доступ администратора к учетной записи поставщика.
  • Расширенная учетная запись : Если вы используете accountAggregation , ваша учетная запись поставщика услуг должна быть расширенной учетной записью, настроенной для агрегации учетных записей. Если вы являетесь поставщиком услуг и вам необходимо настроить расширенную учетную запись, обратитесь в службу поддержки за помощью в настройке.

Создайте учетную запись (используя управление учетными записями или сравнение цен).

Для создания новой учетной записи вызовите метод accounts.createAndConfigure . Это рекомендуемый подход для партнеров, помогающих продавцам управлять своими учетными записями, поскольку он позволяет продавцам сохранять полный контроль и право собственности на свою учетную запись, предоставляя при этом партнерам определенные права доступа.

В теле запроса:

  1. В поле account укажите данные учетной записи, которую вы хотите создать.
  2. Если вы используете accountManagement , укажите в поле user как минимум одного пользователя, который будет иметь доступ к учетной записи.
  3. В поле service укажите все услуги, которые вы хотите предоставить этой учетной записи, например accountManagement , и установите provider в качестве имени ресурса вашей учетной записи (например, providers/ {YOUR_ACCOUNT_ID} ). Список доступных услуг, таких как productsManagement или campaignsManagement , см. в разделе «Управление связями учетных записей» .

Вот пример запроса на создание учетной записи с именем "merchantStore" и привязку ее к учетной записи {YOUR_ACCOUNT_ID} для управления учетными записями и товарами:

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}"
    }
  ]
}

Успешный вызов создает новую учетную запись и связывает ее с вашей учетной записью для указанных сервисов. Если вы указываете сервисы accountManagement , accountAggregation или comparisonShopping при создании, они автоматически утверждаются, и состояние связи становится ESTABLISHED . Другие связи с сервисами могут находиться в состоянии PENDING до тех пор, пока не будут приняты созданной учетной записью. Тело ответа содержит вновь созданный ресурс Account .

После создания такой учетной записи вам необходимо пройти процедуру регистрации, выполнив такие шаги, как принятие Условий предоставления услуг , указание информации о компании и подтверждение веб-сайта .

Отключить подтверждение электронной почты при создании учетной записи.

При создании учетной записи с помощью accounts.createAndConfigure вы можете дополнительно отключить отправку писем с подтверждением новым пользователям, добавленным с помощью поля user , установив параметр verificationMailSettings.verificationMailMode в значение SUPPRESS_VERIFICATION_MAIL в запросе для этого пользователя. Это полезно, если вы планируете проверять пользователей от имени продавца сразу после создания с помощью метода users.verifySelf . По умолчанию verificationMailMode имеет значение SEND_VERIFICATION_MAIL , и письма с подтверждением отправляются новым пользователям, добавленным во время создания учетной записи.

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}"
    }
  ]
}

Если вы установите verificationMailMode в значение SUPPRESS_VERIFICATION_MAIL , вам потребуется вызвать users.verifySelf для каждого пользователя, добавленного при создании, чтобы завершить проверку. Этот вызов должен быть аутентифицирован как пользователь, подлежащий проверке (пользователь, указанный в userId ), например, с использованием токена OAuth от пользователя.

Укажите псевдоним при создании учетной записи.

В запросе CreateAndConfigureAccountRequest можно указать псевдоним для учетной записи в контексте поставщика, используя поле setAlias . Псевдоним можно использовать для идентификации учетной записи в вашей системе. Если вы являетесь поставщиком услуг, вы можете использовать псевдоним для получения учетной записи с помощью GET /accounts/v1/accounts/{provider}~{alias} . Псевдоним должен быть уникальным для данного поставщика, и в поле service запроса необходимо указать услугу с тем же поставщиком. Дополнительную информацию о требованиях к псевдонимам см. в разделе «Управление связями учетных записей» .

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"
    }
  ]
}

Если вы являетесь партнером и создаете учетную запись от имени продавца, мы рекомендуем следующий порядок действий:

  1. Создание учетной записи : вызовите accounts.createAndConfigure , используя учетные данные вашего партнера, чтобы создать новую учетную запись.
    • Настройте service таким образом, чтобы он включал привязку accountManagement к идентификатору вашего провайдера.
    • Добавьте продавца в качестве пользователя, используя поле user , и установите параметр verificationMailSettings.verificationMailMode в значение SUPPRESS_VERIFICATION_MAIL .
  2. Проверка пользователя : Используя учетные данные продавца (например, токен OAuth), вызовите метод users.verifySelf , чтобы изменить состояние пользователя с PENDING на VERIFIED .
  3. Установка страны ведения бизнеса : Используя учетные данные продавца, установите страну ведения бизнеса, обновив значение address.regionCode с помощью accounts.updateBusinessInfo . Это необходимо сделать перед принятием Условий предоставления услуг.
  4. Примите условия обслуживания : Используя учетные данные продавца, примите условия обслуживания .

Этот процесс позволяет продавцу беспрепятственно зарегистрироваться на вашей платформе, не получая пригласительных писем от Google.

Создайте клиентский аккаунт (используя агрегацию аккаунтов).

Клиентские аккаунты — это отдельные аккаунты Merchant Center, связанные с вашим расширенным аккаунтом с помощью сервиса accountAggregation , что позволяет централизованно управлять ими, сохраняя при этом отдельные настройки, веб-сайты и потоки данных. Вы можете использовать под-API Merchant Accounts для создания новых клиентских аккаунтов.

Для создания клиентских аккаунтов необходимо сначала настроить расширенный аккаунт . Для преобразования аккаунта Merchant Center в расширенный аккаунт необходимо иметь права администратора аккаунта, а также в аккаунте не должно быть незавершенных операций .

Для создания новой учетной записи клиента вызовите метод accounts.createAndConfigure . В теле запроса:

  1. В поле account укажите данные учетной записи, которую вы хотите создать.
  2. При желании укажите любых новых авторизованных пользователей в поле user . Доступ пользователя к учетной записи также наследуется от родительской расширенной учетной записи.
  3. В поле service укажите accountAggregation и задайте provider в качестве имени ресурса вашей расширенной учетной записи (например, providers/ {ADVANCED_ACCOUNT_ID} ). Это установит вашу расширенную учетную запись в качестве агрегатора для новой учетной записи.

Вот пример запроса на создание клиентского аккаунта с именем "merchantStore", связанного с расширенным аккаунтом {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}"
    }
  ]
}

Успешный вызов создает новую учетную запись клиента и связывает ее с указанной вами расширенной учетной записью. Тело ответа будет содержать вновь созданный ресурс Account .

Следующие примеры демонстрируют, как можно использовать метод accounts.createAndConfigure для создания новой учетной записи клиента.

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);
  }
}
CreateSubAccountSample.java

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();
CreateSubAccountSample.php

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()

create_sub_account_sample.py

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}"
    }
  ]
}'

Получение клиентских счетов

Чтобы вывести список всех учетных записей клиентов для заданной расширенной учетной записи, используйте метод accounts.listSubaccounts . Укажите идентификатор вашей расширенной учетной записи в поле provider URL-адреса запроса.

Вот пример запроса:

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

Вот пример ответа после успешного звонка: 

{
"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"
    }
  ]
}

Приведенные ниже примеры демонстрируют, как отобразить список всех учетных записей клиентов вашей расширенной учетной записи.

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);
  }
}
ListSubAccountsSample.java

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();
ListSubAccountsSample.php

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()

list_sub_accounts_sample.py

cURL 

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

Удаление учетной записи клиента

Если вам больше не нужно управлять учетной записью клиента, вы можете удалить ее, используя метод accounts.delete .

Для выполнения этого метода требуются права администратора для удаляемой учетной записи.

Вот пример запроса: 

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

В случае успеха тело ответа представляет собой пустой JSON-объект, указывающий на то, что учетная запись была удалена.

Следующие примеры демонстрируют, как удалить учетную запись клиента.

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);
  }
}
DeleteAccountSample.java

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();
DeleteAccountSample.php

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()

delete_account_sample.py

cURL 

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

Примите Условия предоставления услуг

Клиентские аккаунты наследуют Условия предоставления услуг (TOS) Merchant Center, подписанные родительским аккаунтом с расширенными возможностями.

Обновите информацию о вашей компании.

Вы можете использовать API для торговых счетов, чтобы редактировать информацию о компаниях , обслуживающих ваши клиентские счета.

  • Для просмотра информации о компании, зарегистрированной в учетной записи, вызовите метод accounts.getBusinessInfo .
  • Для редактирования информации о компании в учетной записи вызовите функцию accounts.updateBusinessInfo .
Назад
Overview
Далее
Manage Terms of Service