Google My Business API：PHP客户端正确使用readMask获取地点列表

{
  "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 'vendor/autoload.php'; // 确保你已通过Composer安装Google API Client库

/**
 * 这是一个示例函数，用于初始化 Google 客户端。
 * 在实际应用中，你需要根据你的认证方式（如服务账户、OAuth 2.0）来配置 $client。
 *
 * @return Google\Client 已认证的 Google 客户端实例
 */
function getGoogleClient() {
    $client = new Google\Client();
    $client->setApplicationName('My Business API Locations Example');

    // 假设你使用服务账户认证
    // 请替换为你的服务账户凭据文件路径
    $client->setAuthConfig('path/to/your/service_account_credentials.json'); 

    // 或者使用 OAuth 2.0 认证流程
    // $client->setRedirectUri('YOUR_REDIRECT_URI');
    // $client->setAccessToken('YOUR_ACCESS_TOKEN'); // 或使用刷新令牌获取新令牌

    // 设置必要的 API 作用域
    $client->setScopes([
        'https://www.googleapis.com/auth/business.manage' // 管理商家资料的权限
    ]);

    return $client;
}

try {
    $client = getGoogleClient();

    // 1. 获取账户管理服务实例
    $my_business_account = new Google_Service_MyBusinessAccountManagement($client);

    // 2. 列出账户
    $list_accounts_response = $my_business_account->accounts->listAccounts();

    // 检查是否有账户，并选择第一个账户进行操作
    $accounts = $list_accounts_response->getAccounts();
    if (empty($accounts)) {
        echo "未找到任何Google My Business账户。\n";
        exit;
    }
    $account = $accounts[0]; // 获取第一个账户

    echo "正在处理账户: " . $account->getName() . " (显示名称: " . $account->getDisplayName() . ")\n";

    // 3. 获取Business Information服务实例
    $mybusinessService = new Google_Service_MyBusinessBusinessInformation($client);

    // 4. 准备查询参数
    $queryParams = [
        "pageSize" => 10, // 每页获取10个地点
        // 关键点：readMask 必须指定 Location 资源的有效属性。
        // 这些属性可以在 Google My Business Business Information API 的 Location 资源文档中找到。
        // 错误示例：'user.display_name,photo'
        // 正确示例：
        'readMask' => "name,title,websiteUri,address,latlng,primaryCategory.displayName"
        // 更多可选字段：phoneNumbers, storefrontHours, regularHours, specialHours, serviceArea, labels, relations, moreHours, metadata, profile, serviceItems, attributes 等
    ];

    // 5. 列出账户下的地点
    // accounts_locations 是 Google_Service_MyBusinessBusinessInformation 服务下的 Locations 集合
    $locationsList = $mybusinessService->accounts_locations->listAccountsLocations($account->name, $queryParams);

    // 6. 处理返回的地点数据
    $locations = $locationsList->getLocations();
    if (!empty($locations)) {
        echo "成功获取地点列表：\n";
        foreach ($locations as $location) {
            echo "--------------------\n";
            echo "  地点名称: " . $location->getName() . "\n";
            echo "  地点标题: " . $location->getTitle() . "\n";
            if ($location->getWebsiteUri()) {
                echo "  网站URI: " . $location->getWebsiteUri() . "\n";
            }
            if ($location->getAddress()) {
                $address = $location->getAddress();
                echo "  地址: " . implode(", ", $address->getAddressLines()) . ", " 
                     . $address->getLocality() . ", " . $address->getRegionCode() . " " . $address->getPostalCode() . "\n";
            }
            if ($location->getLatlng()) {
                $latlng = $location->getLatlng();
                echo "  经纬度: " . $latlng->getLatitude() . ", " . $latlng->getLongitude() . "\n";
            }
            if ($location->getPrimaryCategory()) {
                echo "  主类别: " . $location->getPrimaryCategory()->getDisplayName() . "\n";
            }
            // 访问其他通过 readMask 请求的字段
        }
        echo "--------------------\n";

        // 如果有下一页，可以继续获取
        if ($locationsList->getNextPageToken()) {
            echo "存在更多地点，下一页令牌: " . $locationsList->getNextPageToken() . "\n";
            // 您可以在此处添加逻辑以获取下一页数据
        }

    } else {
        echo "该账户下未找到任何地点。\n";
    }

} catch (Google\Service\Exception $e) {
    // 捕获 Google API 服务的特定异常
    echo "API调用失败: " . $e->getMessage() . "\n";
    $errors = $e->getErrors();
    if (!empty($errors)) {
        foreach ($errors as $error) {
            echo "错误详情: " . ($error['message'] ?? 'N/A') . "\n";
            echo "错误状态: " . ($error['status'] ?? 'N/A') . "\n";
            if (isset($error['details'][0]['fieldViolations'])) {
                foreach ($error['details'][0]['fieldViolations'] as $violation) {
                    echo "字段违规: " . ($violation['field'] ?? 'N/A') . " - " . ($violation['description'] ?? 'N/A') . "\n";
                }
            }
        }
    }
} catch (Exception $e) {
    // 捕获其他通用异常
    echo "发生未知错误: " . $e->getMessage() . "\n";
}

?>