优化Google My Business API：解决accounts.locations.list中readMask参数的INVALID_ARGUMENT错误

<?php
// ... 假设 $client 已正确初始化并认证 ...

$my_business_account = new Google_Service_MyBusinessAccountManagement($client);
$list_accounts_response = $my_business_account->accounts->listAccounts();
$account = $list_accounts_response[0]; // 获取第一个账户

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

$queryParams = [
    "pageSize" => 10,
    // 错误的 readMask 示例
    'readMask' => "user.display_name,photo" 
];

try {
    $locationsList = $locations->listAccountsLocations($account->name, $queryParams);
    // ... 处理响应 ...
} catch (Google\Service\Exception $e) {
    echo "Google Service Error: " . $e->getMessage() . PHP_EOL;
    // 捕获到的错误响应示例：
    /*
    Google\Service\Exception #400
    {
      "error": {
        "code": 400,
        "message": "Request contains an invalid argument.",
        "status": "INVALID_ARGUMENT",
        "details": [
          {
            "@type": "type.googleapis.com/google.rpc.BadRequest",
            "fieldViolations": [
              {
                "field": "read_mask",
                "description": "Invalid field mask provided"
              }
            ]
          }
        ]
      }
    }
    */
}

<?php
require_once __DIR__ . '/vendor/autoload.php';

// 假设 $client 已经是一个经过认证的 Google_Client 实例。
// 确保 $client 已配置正确的认证凭据和作用域，例如：
// $client = new Google_Client();
// $client->setApplicationName("My Business API Client");
// $client->setScopes(['https://www.googleapis.com/auth/business.manage']);
// $client->setAuthConfig('path/to/your/credentials.json'); // 或其他认证方式

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

    if (empty($list_accounts_response->getAccounts())) {
        echo "No accounts found." . PHP_EOL;
        exit;
    }

    // 获取第一个账户。在实际应用中，您可能需要遍历所有账户或选择特定账户。
    $account = $list_accounts_response->getAccounts()[0]; 

    $mybusinessService = new Google_Service_MyBusinessBusinessInformation($client);
    $locations_service = $mybusinessService->accounts_locations;

    $queryParams = [
        "pageSize" => 10,
        // 正确的 readMask 应该包含 Location 资源的有效字段。
        // 示例：获取商家名称、网站URI和地址。
        'readMask' => "name,title,websiteUri,address" 
        // 您也可以根据需要添加其他字段，如 "phoneNumbers", "primaryCategory", "openInfo" 等。
        // 对于嵌套字段，如需要特定地址组件，可能需要 "address.locality", "address.postalCode" 等，
        // 但通常指定父字段（如 "address"）会返回整个地址对象。
    ];

    echo "Fetching locations for account: " . $account->name . PHP_EOL;
    $locationsList = $locations_service->listAccountsLocations($account->name, $queryParams);

    if ($locationsList->getLocations()) {
        echo "Successfully retrieved locations:" . PHP_EOL;
        foreach ($locationsList->getLocations() as $location) {
            echo "  Location Name (Resource): " . $location->getName() . PHP_EOL;
            echo "  Location Title (Business Name): " . $location->getTitle() . PHP_EOL;
            echo "  Website URI: " . $location->getWebsiteUri() . PHP_EOL;

            // 访问地址信息
            $address = $location->getAddress();
            if ($address) {
                echo "  Address: " . $address->getPostalAddress()->getFormattedAddress() . PHP_EOL;
                // 您可以进一步访问地址的各个组成部分，如 getLocality(), getPostalCode() 等
            }
            echo "--------------------" . PHP_EOL;
        }
    } else {
        echo "No locations found for this account." . PHP_EOL;
    }

} catch (Google\Service\Exception $e) {
    echo "Google Service Error: " . $e->getMessage() . PHP_EOL;
    echo "Details: " . json_encode($e->getErrors(), JSON_PRETTY_PRINT) . PHP_EOL;
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . PHP_EOL;
}