Google My Business API v1：正确使用readMask获取商家位置信息

<?php

require __DIR__ . '/vendor/autoload.php'; // 假设您使用Composer管理依赖

use Google\Client;
use Google\Service\MyBusinessAccountManagement;
use Google\Service\MyBusinessBusinessInformation;
use Google\Service\Exception;

// 假设 $client 已经正确初始化并完成了认证
// 通常需要设置应用凭据或用户凭据
$client = new Client();
$client->setAuthConfig('path/to/your/credentials.json'); // 替换为您的凭据文件路径
$client->addScope('https://www.googleapis.com/auth/business.manage'); // 必要的API范围

try {
    $my_business_account = new MyBusinessAccountManagement($client);
    $list_accounts_response = $my_business_account->accounts->listAccounts();

    if (empty($list_accounts_response->getAccounts())) {
        echo "未找到任何账户。\n";
        exit;
    }

    $account = $list_accounts_response->getAccounts()[0]; // 获取第一个账户

    $mybusinessService = new MyBusinessBusinessInformation($client);
    $locations = $mybusinessService->accounts_locations;

    $queryParams = [
        "pageSize" => 10,
        // 错误示例：readMask 包含了非 Location 资源自身的字段
        'readMask' => "user.display_name,photo" 
    ];

    $locationsList = $locations->listAccountsLocations($account->name, $queryParams);

    // 处理返回的位置数据
    if ($locationsList->getLocations()) {
        foreach ($locationsList->getLocations() as $location) {
            echo "Location Name: " . $location->getName() . "\n";
            // 尝试访问 readMask 中指定的字段，但这里会因为 readMask 错误而无法获取正确数据
        }
    } else {
        echo "未找到任何位置。\n";
    }

} catch (Exception $e) {
    echo "发生错误: " . $e->getMessage() . "\n";
    if ($e->getCode() === 400) {
        // 尝试解析更详细的错误信息
        $errors = json_decode($e->getMessage(), true);
        if (isset($errors['error']['details'][0]['fieldViolations'][0]['description'])) {
            echo "错误详情: " . $errors['error']['details'][0]['fieldViolations'][0]['description'] . "\n";
        }
    }
}

<?php

require __DIR__ . '/vendor/autoload.php'; // 假设您使用Composer管理依赖

use Google\Client;
use Google\Service\MyBusinessAccountManagement;
use Google\Service\MyBusinessBusinessInformation;
use Google\Service\Exception;

// 假设 $client 已经正确初始化并完成了认证
$client = new Client();
$client->setAuthConfig('path/to/your/credentials.json'); // 替换为您的凭据文件路径
$client->addScope('https://www.googleapis.com/auth/business.manage'); // 必要的API范围

try {
    $my_business_account = new MyBusinessAccountManagement($client);
    $list_accounts_response = $my_business_account->accounts->listAccounts();

    if (empty($list_accounts_response->getAccounts())) {
        echo "未找到任何账户。\n";
        exit;
    }

    $account = $list_accounts_response->getAccounts()[0]; // 获取第一个账户

    $mybusinessService = new MyBusinessBusinessInformation($client);
    $locations = $mybusinessService->accounts_locations;

    $queryParams = [
        "pageSize" => 10,
        // 正确示例：readMask 包含了 Location 资源自身的有效字段
        'readMask' => "name,title,storeCode,websiteUri,address"
    ];

    $locationsList = $locations->listAccountsLocations($account->name, $queryParams);

    if ($locationsList->getLocations()) {
        echo "成功获取商家位置列表：\n";
        foreach ($locationsList->getLocations() as $location) {
            echo "----------------------------------------\n";
            echo "位置名称 (API Name): " . $location->getName() . "\n";
            echo "商家标题 (Title): " . $location->getTitle() . "\n";
            echo "门店代码 (Store Code): " . $location->getStoreCode() . "\n";
            echo "网站URI (Website URI): " . $location->getWebsiteUri() . "\n";
            // 获取地址信息，地址是一个对象，需要进一步解析
            $address = $location->getAddress();
            if ($address) {
                echo "地址: " . $address->getPostalCode() . " " . $address->getLocality() . ", " . $address->getAdministrativeArea() . ", " . $address->getRegionCode() . "\n";
            }
        }
    } else {
        echo "未找到任何位置。\n";
    }

} catch (Exception $e) {
    echo "发生错误: " . $e->getMessage() . "\n";
    if ($e->getCode() === 400) {
        $errors = json_decode($e->getMessage(), true);
        if (isset($errors['error']['details'][0]['fieldViolations'][0]['description'])) {
            echo "错误详情: " . $errors['error']['details'][0]['fieldViolations'][0]['description'] . "\n";
        }
    }
}