กลุ่มสถานที่ตั้งธุรกิจของ Google เป็นเหมือนโฟลเดอร์ที่ใช้ร่วมกันของสถานที่ตั้ง กลุ่มสถานที่ตั้งธุรกิจมอบวิธีที่ปลอดภัยในการแชร์การจัดการสถานที่ของคุณ กับผู้ใช้หลายๆ ราย ดูข้อมูลเพิ่มเติมได้ที่ เกี่ยวกับกลุ่มสถานที่ตั้งธุรกิจ
ก่อนอัปโหลดสินค้าคงคลังในร้าน ให้ระบุกลุ่มสถานที่ตั้งธุรกิจที่บัญชี Merchant Center จะรับผิดชอบ คุณดูรายการกลุ่มสถานที่ตั้งธุรกิจที่มีสิทธิ์ได้จาก Business Profile โดยใช้ Merchant API แต่ก่อนจะเข้าถึงได้ คุณต้องลิงก์บัญชีกับ Business Profile ก่อน
ขอสิทธิ์เข้าถึง Business Profile
หากต้องการเข้าถึง Business Profile ให้ใช้วิธีgbpAccounts.LinkGbpAccount
ต่อไปนี้
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/gbpAccounts:linkGbpAccount
{
"gbpEmail": "admin@example.com",
}
แทนที่ค่าต่อไปนี้
ACCOUNT_ID: ตัวระบุที่ไม่ซ้ำกันของบัญชี Merchant CenterGBP_EMAIL: อีเมลของผู้ดูแลระบบสำหรับ Business Profile
เมื่อเรียกใช้เมธอดนี้ บริการจะส่งอีเมลไปยังผู้ดูแลระบบที่ระบุเพื่อขอให้ยอมรับหรือปฏิเสธคำขอเข้าถึง หากผู้ดูแลระบบไม่ตอบกลับภายใน 7 วัน คำขอจะหมดอายุโดยอัตโนมัติ
แสดงรายการกลุ่มสถานที่ตั้งธุรกิจที่ใช้ได้
เมื่อผู้ดูแลระบบอนุมัติคำขอแล้ว คุณจะตรวจสอบกลุ่มธุรกิจที่พร้อมใช้งานได้โดยใช้เมธอด gbpAccounts.List
ตัวอย่างคำขอและการตอบกลับที่สำเร็จมีดังนี้
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/gbpAccounts
Response:
200 OK
{
"gbpAccounts": [
{
"name": "accounts/{ACCOUNT_ID}/gbpAccounts/12345",
"gbpAccountId": 12345,
"type": USER,
"gbpAccountName": "admin@example.com",
"listingCount": 15
}, {
"name": "accounts/{ACCOUNT_ID}/gbpAccounts/67890",
"gbpAccountId": 67890,
"type": BUSINESS_ACCOUNT,
"gbpAccountName": "Google My Business Account",
"listingCount": 23
}
],
"nextPageToken": 50
}
คุณสามารถใช้ตัวอย่างโค้ดนี้เพื่อดึงข้อมูลกลุ่มธุรกิจที่มีสิทธิ์ทั้งหมดได้
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.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 credentials retrieved above.
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 occured: ");
System.out.println(e);
}
}
public static void main(String[] args) throws Exception {
Config config = Config.load();
listGbpAccounts(config);
}
}
PHP
require_once __DIR__ . '/../../../../vendor/autoload.php';
require_once __DIR__ . '/../../../Authentication/Authentication.php';
require_once __DIR__ . '/../../../Authentication/Config.php';
use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1\Client\GbpAccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1\GbpAccount;
use Google\Shopping\Merchant\Accounts\V1\ListGbpAccountsRequest;
/**
* This class demonstrates how to get the list of GBP accounts for a given
* Merchant Center account.
*/
class ListGbpAccountsSample
{
/**
* A helper function to create the parent string.
*
* @param string $accountId The account ID.
*
* @return string The parent has the format: `accounts/{account_id}`
*/
private static function getParent(string $accountId): string
{
return sprintf('accounts/%s', $accountId);
}
/**
* Retrieves the list of GBP accounts for a given Merchant Center account.
*
* @param array $config The configuration data for authentication and account ID.
*
* @return void
*/
public static function listGbpAccounts(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.
$gbpAccountsServiceClient = new GbpAccountsServiceClient($options);
// Creates the parent account name to identify the merchant.
$parent = self::getParent($config['accountId']);
// Creates the request to list GBP accounts.
$request = new ListGbpAccountsRequest([
'parent' => $parent
]);
// Calls the API and catches and prints any network failures/errors.
try {
printf("Sending list GBP accounts request:%s", PHP_EOL);
$response = $gbpAccountsServiceClient->listGbpAccounts($request);
$count = 0;
// Iterates over all the GBP accounts in the response and prints them.
foreach ($response->iterateAllElements() as $gbpAccount) {
/** @var GbpAccount $gbpAccount */
print_r($gbpAccount->serializeToJsonString());
$count++;
}
printf(
"The following count of elements were returned: %d%s",
$count,
PHP_EOL
);
} catch (ApiException $e) {
printf("An error has occurred: %s%s", $e->getMessage(), PHP_EOL);
}
}
/**
* Helper to execute the sample.
*
* @return void
*/
public function callSample(): void
{
$config = Config::generateConfig();
self::listGbpAccounts($config);
}
}
// Runs the script.
$sample = new ListGbpAccountsSample();
$sample->callSample();
Python
from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1 import GbpAccountsServiceClient
from google.shopping.merchant_accounts_v1 import ListGbpAccountsRequest
# Gets the merchant account ID from the configuration file.
_ACCOUNT = configuration.Configuration().read_merchant_info()
# Creates the parent resource name string.
_PARENT = f"accounts/{_ACCOUNT}"
def list_gbp_accounts() -> None:
"""Lists the Google Business Profile accounts for a given Merchant Center account."""
# Gets OAuth Credentials.
credentials = generate_user_credentials.main()
# Creates a client.
client = GbpAccountsServiceClient(credentials=credentials)
# Creates the request.
request = ListGbpAccountsRequest(parent=_PARENT)
# Makes the request and catches and prints any error messages.
try:
print("Sending list GBP accounts request:")
# Makes the request and retrieves the list of GBP accounts.
response = client.list_gbp_accounts(request=request)
count = 0
# Iterates over all the GBP accounts in the response and prints them.
for gbp_account in response:
print(gbp_account)
count += 1
print(f"The following count of elements were returned: {count}")
except RuntimeError as e:
print("An error has occured: ")
print(e)
if __name__ == "__main__":
list_gbp_accounts()
ระบุกลุ่มสถานที่ตั้งธุรกิจสำหรับบัญชี Merchant Center
รายการกลุ่มสถานที่ตั้งธุรกิจที่พร้อมใช้งาน คุณสามารถเชื่อมโยงกลุ่มสถานที่ตั้งธุรกิจ
กับบัญชี Merchant Center ได้ ตัวอย่างเช่น หากต้องการเลือก
กลุ่มสถานที่ตั้งธุรกิจที่มีรหัสบัญชี GBP 12345 (ส่งคืนจากขั้นตอนก่อนหน้า
) คุณสามารถใช้ AccountServices.proposeAccountService ได้
POST
https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/services:propose
{
provider: "providers/GOOGLE_BUSINESS_PROFILE",
account_service: {
external_account_id: "12345",
local_listing_management {}
}
}
โปรดทราบว่าฟิลด์ provider ต้องเป็น providers/GOOGLE_BUSINESS_PROFILE คุณต้องตั้งค่าฟิลด์ LocalListingManagement ในคำขอให้ว่างเปล่า
ส่งข้อมูลผลิตภัณฑ์และสินค้าคงคลัง
ตอนนี้คุณได้เชื่อมโยงบัญชี Merchant Center กับกลุ่มสถานที่ตั้งธุรกิจแล้ว คุณสามารถอัปโหลดข้อมูลผลิตภัณฑ์และสินค้าคงคลังในร้านได้ สำหรับข้อมูลเพิ่มเติม โปรดดู