เราได้หยุดให้บริการและปิด Merchant API v1beta ในวันที่ 28 กุมภาพันธ์ 2026 ดูขั้นตอนการเปลี่ยนไปใช้เวอร์ชันเสถียรล่าสุดได้ที่ย้ายข้อมูลจาก v1beta ไปยัง v1

สร้างบัญชี

คุณสามารถใช้ Merchant API เพื่อสร้างบัญชี Merchant Center ซึ่งสามารถ ลิงก์กับ บัญชีขั้นสูง ได้โดยใช้ accountAggregation, accountManagement หรือ comparisonShopping เมธอด accounts.createAndConfigure ช่วยให้คุณสร้างบัญชีและกำหนดค่าบัญชีด้วยผู้ใช้ รวมถึง ลิงก์บัญชีกับบัญชีอื่นๆ ผ่านบริการต่างๆ ได้ (ไม่บังคับ)

คู่มือนี้อธิบายวิธีใช้ Merchant API เพื่อสร้างบัญชีโดยใช้บริการต่างๆ เช่น accountManagement, comparisonShopping หรือ accountAggregation เมื่อใช้ accounts.createAndConfigure คุณต้องลิงก์บัญชีใหม่กับผู้ให้บริการโดยระบุ accountAggregation, accountManagement หรือ comparisonShopping อย่างน้อย 1 รายการในช่อง service คุณสามารถระบุ accountAggregation และ comparisonShopping ในคำขอเดียวกันได้ แต่จะรวม accountManagement กับ accountAggregation หรือ comparisonShopping ไม่ได้ หากระบุ accountManagement คุณต้องเพิ่มผู้ใช้อย่างน้อย 1 รายการลงใน บัญชีใหม่โดยใช้ช่อง user หรือ users

ข้อกำหนดเบื้องต้น

ก่อนที่จะสร้างบัญชีโดยใช้ Merchant API ได้ โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้ ทั้งนี้ขึ้นอยู่กับบริการที่คุณใช้

สิทธิ์เข้าถึงระดับผู้ดูแลระบบ: คุณต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบใน บัญชีผู้ให้บริการเมื่อลิงก์บัญชีใหม่โดยใช้ accountManagement, comparisonShopping หรือ accountAggregation
บัญชีขั้นสูง: หากใช้ accountAggregation บัญชีผู้ให้บริการ ต้องเป็นบัญชีขั้นสูง ที่กำหนดค่าสำหรับการรวมบัญชี หากคุณเป็นผู้ให้บริการและต้องการ ตั้งค่าบัญชีขั้นสูง โปรดติดต่อทีมสนับสนุนเพื่อ ขอความช่วยเหลือในการกำหนดค่า

สร้างบัญชี (โดยใช้การจัดการบัญชีหรือการเปรียบเทียบราคา)

หากต้องการสร้างบัญชีใหม่ ให้เรียก accounts.createAndConfigure วิธีนี้เป็นวิธีที่แนะนำสำหรับพาร์ทเนอร์ที่ช่วยผู้ขายจัดการบัญชี เนื่องจากช่วยให้ผู้ขายควบคุมและเป็นเจ้าของบัญชีได้อย่างเต็มที่ในขณะที่ให้สิทธิ์เฉพาะแก่พาร์ทเนอร์

ในเนื้อหาคำขอ ให้ทำดังนี้

ระบุรายละเอียดของบัญชีที่ต้องการสร้างในช่อง account
ในช่อง accountName ให้หลีกเลี่ยงการใช้เครื่องหมายวรรคตอนซ้ำๆ และไม่จำเป็น การขึ้นต้นด้วยตัวพิมพ์ใหญ่ ขีดล่าง ตัวพิมพ์ใหญ่ทั้งหมด อีโมจิ หรือสัญลักษณ์ที่ไม่ใช่ตัวอักษรและตัวเลข เช่น / หรือ _ หลีกเลี่ยงคำต่อท้ายของชื่อธุรกิจ (เช่น "Inc." หรือ "GmbH") ข้อความโปรโมต ข้อมูลส่วนบุคคล หรือภาษาที่ไม่เหมาะสม ใช้ชื่อที่สั้น ชัดเจน และเป็นทางการ ดูข้อมูลเพิ่มเติมได้ที่ การเพิ่มชื่อธุรกิจ
หากใช้ accountManagement ให้ระบุผู้ใช้ในช่อง user อย่างน้อย 1 รายการที่จะมีสิทธิ์เข้าถึงบัญชี
ในช่อง 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"
    }
  ]
}

ขั้นตอนการเริ่มต้นใช้งานที่แนะนำ

หากคุณเป็นพาร์ทเนอร์ที่สร้างบัญชีในนามของผู้ขาย เราขอแนะนำให้ทำตามขั้นตอนต่อไปนี้

สร้างบัญชี: เรียก accounts.createAndConfigure ด้วย ข้อมูลเข้าสู่ระบบของพาร์ทเนอร์เพื่อสร้างบัญชีใหม่
- ตั้งค่า service ให้รวม accountManagement ที่ลิงก์กับรหัสผู้ให้บริการ
- เพิ่มผู้ขายเป็นผู้ใช้โดยใช้ช่อง user และตั้งค่า verificationMailSettings.verificationMailMode เป็น SUPPRESS_VERIFICATION_MAIL
ยืนยันผู้ใช้: ด้วยข้อมูลเข้าสู่ระบบจากผู้ขาย (เช่น โดยใช้ โทเค็น OAuth) เรียก users.verifySelf เพื่อเปลี่ยนสถานะผู้ใช้จาก PENDING เป็น VERIFIED
ตั้งค่าประเทศของธุรกิจ: ตั้งค่าประเทศของธุรกิจโดยอัปเดต address.regionCode โดยใช้ accounts.updateBusinessInfo ด้วยข้อมูลเข้าสู่ระบบของผู้ขาย คุณต้องดำเนินการนี้ก่อนยอมรับข้อกำหนดในการให้บริการ
ยอมรับข้อกำหนดในการให้บริการ: ด้วยข้อมูลเข้าสู่ระบบของผู้ขาย ยอมรับข้อกำหนดในการให้บริการ

ขั้นตอนการทำงานนี้ช่วยให้ผู้ขายเริ่มต้นใช้งานแพลตฟอร์มของคุณได้อย่างราบรื่นโดยไม่ต้องรับอีเมลคำเชิญจาก Google

สร้างบัญชีลูกค้า (โดยใช้การรวมบัญชี)

บัญชีลูกค้าเป็นบัญชี Merchant Center ที่แยกต่างหากซึ่งลิงก์กับบัญชีขั้นสูงโดยใช้บริการ accountAggregation ซึ่งช่วยให้จัดการจากส่วนกลางได้ในขณะที่ยังคงการตั้งค่า เว็บไซต์ และฟีดข้อมูลแยกกัน คุณสามารถใช้ Merchant Accounts Sub-API เพื่อสร้างบัญชีลูกค้าใหม่ได้

หากต้องการสร้างบัญชีลูกค้า คุณต้องตั้งค่าบัญชี ขั้นสูงก่อน คุณ ต้องเป็นผู้ดูแลระบบบัญชีจึงจะเปลี่ยนบัญชี Merchant Center เป็น บัญชีขั้นสูงได้ และบัญชีของคุณต้องไม่มี ปัญหาที่รอดำเนินการ

หากต้องการสร้างบัญชีลูกค้าใหม่ ให้เรียก accounts.createAndConfigure ในเนื้อหาคำขอ ให้ทำดังนี้

ระบุรายละเอียดของบัญชีที่ต้องการสร้างในช่อง account
ในช่อง accountName ให้หลีกเลี่ยงการใช้เครื่องหมายวรรคตอน การขึ้นต้นด้วยตัวพิมพ์ใหญ่ ขีดล่าง หรือสัญลักษณ์ที่ไม่ใช่ตัวอักษรและตัวเลข (เช่น "/" หรือ "_") ซ้ำๆ และไม่จำเป็น หลีกเลี่ยงคำต่อท้ายของชื่อธุรกิจ (เช่น "Inc." หรือ "GmbH") ข้อความโปรโมต ข้อมูลส่วนบุคคล หรือภาษาที่ไม่เหมาะสม ใช้ชื่อที่สั้น ชัดเจน และเป็นทางการ ดูข้อมูลเพิ่มเติมได้ที่ การเพิ่มชื่อธุรกิจ
คุณสามารถระบุผู้ใช้ที่ได้รับอนุญาตใหม่ใน user ได้ (ไม่บังคับ) นอกจากนี้ บัญชีจะได้รับสิทธิ์เข้าถึงของผู้ใช้จากบัญชีขั้นสูงหลักด้วย
ใน 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 ที่บัญชีขั้นสูงหลักลงนามไว้

อัปเดตข้อมูลทางธุรกิจ

คุณสามารถใช้ Accounts Sub-API เพื่อแก้ไขข้อมูล ทางธุรกิจสำหรับ บัญชีลูกค้าได้

หากต้องการดูข้อมูลทางธุรกิจของบัญชี ให้เรียก accounts.getBusinessInfo
หากต้องการแก้ไขข้อมูลทางธุรกิจของบัญชี ให้เรียก accounts.updateBusinessInfo

Overview

Account relationships