PHP集成Google My Business Business Information API：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 autoload文件已加载

// 假设 $client 已经是一个经过认证的 Google_Client 实例
// 并且已经设置了正确的Scopes，例如 Google_Service_MyBusinessBusinessInformation::MYBUSINESS_BUSINESSINFORMATION
// 示例：
// $client = new Google_Client();
// $client->setAuthConfig('path/to/your/credentials.json');
// $client->setScopes([Google_Service_MyBusinessBusinessInformation::MYBUSINESS_BUSINESSINFORMATION, Google_Service_MyBusinessAccountManagement::MYBUSINESS_ACCOUNTMANAGEMENT]);
// $client->setAccessType('offline'); // 如果需要刷新令牌

try {
    // 1. 获取账户信息
    $my_business_account = new Google_Service_MyBusinessAccountManagement($client);
    $list_accounts_response = $my_business_account->accounts->listAccounts();

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

    // 通常选择第一个账户，或者根据业务逻辑选择特定账户
    $account = $list_accounts_response->getAccounts()[0];
    echo "正在处理账户: " . $account->getName() . "\n";

    // 2. 初始化 MyBusinessBusinessInformation 服务
    $mybusinessService = new Google_Service_MyBusinessBusinessInformation($client);
    $locations_service = $mybusinessService->accounts_locations;

    // 3. 定义查询参数，重点是正确的 readMask
    $queryParams = [
        "pageSize" => 10,
        // 修正：readMask 必须指定 Location 资源本身的有效字段
        // 这里请求了名称、标题、商家代码、网站URI、地址和电话号码
        'readMask' => "name,title,storeCode,websiteUri,address,phoneNumbers"
    ];

    // 4. 调用 API 获取位置列表
    $locationsListResponse = $locations_service->listAccountsLocations($account->name, $queryParams);

    if (empty($locationsListResponse->getLocations())) {
        echo "该账户下未找到任何商家位置。\n";
        exit;
    }

    echo "成功获取商家位置列表：\n";
    foreach ($locationsListResponse->getLocations() as $location) {
        echo "  - 位置名称 (Resource Name): " . $location->getName() . "\n";
        echo "  - 商家标题 (Title): " . $location->getTitle() . "\n";
        if ($location->getStoreCode()) {
            echo "  - 商家代码 (Store Code): " . $location->getStoreCode() . "\n";
        }
        if ($location->getWebsiteUri()) {
            echo "  - 网站 (Website): " . $location->getWebsiteUri() . "\n";
        }
        // 地址字段是一个复杂对象，需要进一步解析
        if ($location->getAddress()) {
            $postalAddress = $location->getAddress()->getPostalAddress();
            if ($postalAddress) {
                echo "  - 地址 (Address): " . implode(", ", $postalAddress->getAddressLines()) . ", " . $postalAddress->getLocality() . "\n";
            }
        }
        // 电话号码字段也是一个复杂对象
        if ($location->getPhoneNumbers() && $location->getPhoneNumbers()->getPrimaryPhone()) {
            echo "  - 主要电话 (Primary Phone): " . $location->getPhoneNumbers()->getPrimaryPhone() . "\n";
        }
        echo "---\n";
    }

    // 处理分页，如果有更多结果
    $nextPageToken = $locationsListResponse->getNextPageToken();
    if ($nextPageToken) {
        echo "还有更多结果，可以通过 nextPageToken 继续获取。\n";
        // 示例：获取下一页
        // $queryParams['pageToken'] = $nextPageToken;
        // $nextLocationsListResponse = $locations_service->listAccountsLocations($account->name, $queryParams);
    }

} catch (Google\Service\Exception $e) {
    echo "API 调用出错: " . $e->getMessage() . "\n";
    echo "错误详情: " . (isset($e->getErrors()[0]['message']) ? $e->getErrors()[0]['message'] : '未知错误') . "\n";
    // 更多错误处理，例如根据错误码进行不同处理
} catch (Exception $e) {
    echo "发生未知错误: " . $e->getMessage() . "\n";
}

?>