ลิงก์ Google Business Profile

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

ก่อนอัปโหลดสินค้าคงคลังในร้าน ให้ระบุกลุ่มสถานที่ตั้งธุรกิจที่บัญชี Merchant Center ของคุณจะรับผิดชอบ คุณดูรายการกลุ่มสถานที่ตั้งธุรกิจที่มีสิทธิ์ได้จาก Business Profile โดยใช้ Merchant API แต่หากต้องการเข้าถึง คุณต้องลิงก์บัญชีกับ Business Profile ก่อน

ขอสิทธิ์เข้าถึง Business Profile

หากต้องการเข้าถึง Business Profile ให้ใช้gbpAccounts.LinkGbpAccountวิธีต่อไปนี้

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

{
  "gbpEmail": "[e-mail]",
}

แทนที่ค่าต่อไปนี้

• ACCOUNT_ID: ตัวระบุที่ไม่ซ้ำกันของบัญชี Merchant Center
• GBP_EMAIL: อีเมลของผู้ดูแลระบบสำหรับ Business Profile

เมื่อเรียกใช้เมธอดนี้ บริการจะส่งอีเมลถึงผู้ดูแลระบบที่ระบุเพื่อขอให้ยอมรับหรือปฏิเสธคำขอเข้าถึง หากผู้ดูแลระบบไม่ตอบกลับภายใน 7 วัน คำขอจะหมดอายุโดยอัตโนมัติ

แสดงรายการกลุ่มสถานที่ตั้งธุรกิจที่ใช้ได้

เมื่อผู้ดูแลระบบอนุมัติคำขอแล้ว คุณจะตรวจสอบกลุ่มธุรกิจที่ใช้ได้โดยใช้เมธอด gbpAccounts.List

ตัวอย่างคําขอและการตอบกลับที่ประสบความสําเร็จมีดังนี้

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

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

คุณสามารถใช้ตัวอย่างโค้ดนี้เพื่อดึงข้อมูลกลุ่มธุรกิจที่มีสิทธิ์ทั้งหมดได้

package shopping.merchant.samples.accounts.v1;

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

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

  public static void listGbpAccounts(Config config) throws Exception {

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

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

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

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

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

      int count = 0;

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

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

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

ระบุกลุ่มสถานที่ตั้งธุรกิจสำหรับบัญชี Merchant Center

ของกลุ่มสถานที่ตั้งธุรกิจที่ใช้ได้ คุณสามารถเชื่อมโยงกลุ่มสถานที่ตั้งธุรกิจกับบัญชี Merchant Center ได้ เช่น หากต้องการเลือกกลุ่มธุรกิจที่มีรหัสบัญชี GBP 12345 (แสดงผลจากขั้นตอนก่อนหน้า) คุณจะใช้ AccountServices.proposeAccountService ดังนี้

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

โปรดทราบว่าฟิลด์ provider ต้องมีค่าเป็น providers/GOOGLE_BUSINESS_PROFILE คุณต้องตั้งค่าฟิลด์ LocalListingManagement ว่างในคำขอ

ส่งข้อมูลผลิตภัณฑ์และสินค้าคงคลัง

เมื่อเชื่อมโยงบัญชี Merchant Center กับกลุ่มสถานที่ตั้งธุรกิจแล้ว คุณจะอัปโหลดข้อมูลผลิตภัณฑ์และสินค้าคงคลังในร้านได้ สำหรับข้อมูลเพิ่มเติม โปรดดู

• คู่มือเริ่มต้นใช้งาน LFP
• Local Inventory API