您可以下载我们的 Java 实时更新 API 客户端,有助于开始实现 实时更新
前提条件:
创建服务账号,然后下载私钥。
开始使用:
- 下载 Java 客户端库会将文件解压缩到“mapsbooking” 软件包。
-
在 IDE 中创建 Java 项目,下载示例代码 InventoryUpdate.java 和 BookingNotification.java:
git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
并将其导入 src 目录下的 Java 项目中。
- 将您的私钥(JSON 文件)副本复制到 src 目录。
- 将 Java 客户端库添加到项目的依赖项中 (在 mapsbooking 和 libs-sources 目录下包括 jar 文件)。
- 在两个 Java 文件中,都按照 TODO 完成您的实现
如需关于 REST API 的更多详细信息,请 点击此处。
问题排查:
-
尝试使用现有 merchantId 或 serviceId,您将收到以下错误消息:
409 Conflict { “code” : 409, “errors” : [{ “domain” : “global”, “message” : “Requested entity already exists”, “reason” : “alreadyExists”, “debugInfo” : “detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n" }], “message” : “Requested entity already exists”, “status” : “ALREADY_EXISTS” }
- 使用无效 merchantId 或 serviceId,调用将不会抛出错误消息。这是因为 通过 RTU 对可用性空档进行更改支持无序执行, 因此不与 merchantId 或 serviceId 相关联。不过,这些槽 由于无效 merchantId 或 serviceId。要使这些广告位可投放,请将 通过 RTU 或 Feed 发送商家或服务信息。
- 在所有更新函数中,参数“updateMask”必须 FieldMask 格式来指定要更新的字段。API 是 只需更改掩码中指定的字段的值 其他组件则保持不变如果传递错误的 updateMask 字符串, 更新不会生效。如果在更新时不存在字段掩码, 该操作适用于所有字段(就好像所有字段的字段掩码具有 )。如果您想更新所有字段,只需将 updateMask 为空。
- 任何包含零值的字段都不会显示在响应中。