Google Business Performance API มีเมธอด API
ใหม่ที่อนุญาตให้ดึง `DailyMetrics` หลายรายการในคําขอ API รายการเดียว
ตรวจสอบ
กําหนดการเลิกใช้งานและวิธีการย้ายข้อมูลจากเมธอด v4 reportInsights API ไปยัง API ประสิทธิภาพของ Google Business Profile
REST Resource: locations.placeActionLinks
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แหล่งข้อมูล: PlaceActionLink
แสดงลิงก์การดำเนินการเกี่ยวกับสถานที่และแอตทริบิวต์
| การแสดง JSON |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| ช่อง |
name |
string
ไม่บังคับ ชื่อทรัพยากรในรูปแบบ locations/{locationId}/placeActionLinks/{place_action_link_id} ฟิลด์ชื่อจะได้รับการพิจารณาเฉพาะในคำขอplaceActionLinks.patch และ PlaceActionLinks.delete สำหรับการอัปเดตและลบลิงก์ตามลำดับ อย่างไรก็ตาม ระบบจะไม่พิจารณาคำขอ PlaceActionLinks.create ซึ่งเซิร์ฟเวอร์จะกำหนด place_action_link_id เมื่อสร้างลิงก์ใหม่สำเร็จและแสดงผลเป็นส่วนหนึ่งของการตอบกลับ
|
providerType |
enum (ProviderType)
เอาต์พุตเท่านั้น ระบุประเภทผู้ให้บริการ
|
isEditable |
boolean
เอาต์พุตเท่านั้น ระบุว่าไคลเอ็นต์จะแก้ไขลิงก์นี้ได้หรือไม่
|
uri |
string
ต้องระบุ URI ลิงก์ URI เดียวกันสามารถใช้ซ้ำสำหรับการดำเนินการประเภทต่างๆ ในสถานที่ต่างๆ ได้ อย่างไรก็ตาม อนุญาตให้มีลิงก์การดำเนินการเกี่ยวกับสถานที่ได้เพียงลิงก์เดียวสำหรับชุดค่าผสมที่ไม่ซ้ำกันแต่ละชุด (uri, ประเภทการดำเนินการเกี่ยวกับสถานที่, ตำแหน่ง)
|
placeActionType |
enum (PlaceActionType)
ต้องระบุ ประเภทของการดำเนินการเกี่ยวกับสถานที่ที่สามารถทำได้โดยใช้ลิงก์นี้
|
isPreferred |
boolean
ไม่บังคับ ผู้ขายต้องการลิงก์นี้หรือไม่ ทำเครื่องหมายลิงก์เป็นที่ต้องการได้ 1 ลิงก์ต่อ 1 ประเภทการดำเนินการเกี่ยวกับสถานที่ที่ตำแหน่ง 1 ตำแหน่ง หากคำขอในอนาคตระบุว่าลิงก์อื่นเป็นที่ต้องการสำหรับประเภทการดำเนินการเกี่ยวกับสถานที่เดียวกัน ลิงก์ที่ต้องการในปัจจุบัน (หากมี) จะหายไปที่ต้องการ
|
createTime |
string (Timestamp format)
เอาต์พุตเท่านั้น เวลาที่สร้างลิงก์การดำเนินการเกี่ยวกับสถานที่ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
|
updateTime |
string (Timestamp format)
เอาต์พุตเท่านั้น เวลาที่แก้ไขลิงก์การดำเนินการเกี่ยวกับสถานที่ครั้งล่าสุด การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
|
ProviderType
ประเภทของผู้ให้บริการลิงก์ สามารถอ่านได้เท่านั้น
| Enum |
PROVIDER_TYPE_UNSPECIFIED |
ไม่ได้ระบุ |
MERCHANT |
ผู้ให้บริการบุคคลที่หนึ่ง เช่น ผู้ขาย หรือตัวแทนในนามของผู้ขาย |
AGGREGATOR_3P |
ผู้รวบรวมข้อมูล 3P เช่น พาร์ทเนอร์ Reserve with Google |
PlaceActionType
ประเภทของการดำเนินการเกี่ยวกับสถานที่ที่สามารถทำได้โดยใช้ลิงก์
| Enum |
PLACE_ACTION_TYPE_UNSPECIFIED |
ไม่ได้ระบุ |
APPOINTMENT |
ประเภทการดำเนินการคือการจองการนัดหมาย |
ONLINE_APPOINTMENT |
ประเภทการดำเนินการคือการจองการนัดหมายออนไลน์ |
DINING_RESERVATION |
ประเภทการดำเนินการคือการจองโต๊ะอาหาร |
FOOD_ORDERING |
ประเภทการดำเนินการคือการสั่งอาหารแบบจัดส่งถึงบ้านและ/หรือสั่งกลับบ้าน |
FOOD_DELIVERY |
ประเภทการดำเนินการคือการสั่งอาหารให้จัดส่ง |
FOOD_TAKEOUT |
ประเภทการดำเนินการคือการสั่งอาหารสำหรับสั่งกลับบ้าน |
SHOP_ONLINE |
ประเภทการดำเนินการคือ "ช็อปปิ้ง" ซึ่งอาจเป็นแบบจัดส่งและ/หรือรับสินค้าก็ได้ |
เมธอด |
|
|
สร้างลิงก์การดำเนินการเกี่ยวกับสถานที่ที่เชื่อมโยงกับตำแหน่งที่ระบุ และแสดงลิงก์ดังกล่าว |
|
|
ลบลิงก์การดำเนินการเกี่ยวกับสถานที่ออกจากตําแหน่งที่ระบุ |
|
|
รับลิงก์การดำเนินการเกี่ยวกับสถานที่ที่ระบุ |
|
|
แสดงลิงก์การดำเนินการเกี่ยวกับสถานที่สำหรับตำแหน่งที่ระบุ |
|
|
อัปเดตลิงก์การดำเนินการเกี่ยวกับสถานที่ที่ระบุและแสดงลิงก์ดังกล่าว |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e resource represents a link associated with a Google Business Profile location, allowing customers to take actions like booking appointments or ordering food.\u003c/p\u003e\n"],["\u003cp\u003eLinks are categorized by \u003ccode\u003eProviderType\u003c/code\u003e (merchant, aggregator) and \u003ccode\u003ePlaceActionType\u003c/code\u003e (appointment, order, etc.) and can be managed through create, delete, get, list, and patch methods.\u003c/p\u003e\n"],["\u003cp\u003eEach link has attributes like \u003ccode\u003euri\u003c/code\u003e, \u003ccode\u003eisEditable\u003c/code\u003e, and \u003ccode\u003eisPreferred\u003c/code\u003e, providing control and information about the link's behavior and status.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e includes timestamps for creation and updates (\u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003eupdateTime\u003c/code\u003e) enabling tracking of link history.\u003c/p\u003e\n"]]],[],null,["# REST Resource: locations.placeActionLinks\n\n- [Resource: PlaceActionLink](#PlaceActionLink)\n - [JSON representation](#PlaceActionLink.SCHEMA_REPRESENTATION)\n- [ProviderType](#ProviderType)\n- [PlaceActionType](#PlaceActionType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PlaceActionLink\n-------------------------\n\nRepresents a place action link and its attributes.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"providerType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType), \"isEditable\": boolean, \"uri\": string, \"placeActionType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType), \"isPreferred\": boolean, \"createTime\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Optional. The resource name, in the format `locations/{locationId}/placeActionLinks/{place_action_link_id}`. The name field will only be considered in placeActionLinks.patch and placeActionLinks.delete requests for updating and deleting links respectively. However, it will be ignored in placeActionLinks.create request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response. |\n| `providerType` | `enum (`[ProviderType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType)`)` Output only. Specifies the provider type. |\n| `isEditable` | `boolean` Output only. Indicates whether this link can be edited by the client. |\n| `uri` | `string` Required. The link uri. The same uri can be reused for different action types across different locations. However, only one place action link is allowed for each unique combination of (uri, place action type, location). |\n| `placeActionType` | `enum (`[PlaceActionType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType)`)` Required. The type of place action that can be performed using this link. |\n| `isPreferred` | `boolean` Optional. Whether this link is preferred by the merchant. Only one link can be marked as preferred per place action type at a location. If a future request marks a different link as preferred for the same place action type, then the current preferred link (if any exists) will lose its preference. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was created. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\nProviderType\n------------\n\nThe type of the link provider, can only be read.\n\n| Enums ||\n|-----------------------------|-------------------------------------------------------------------------|\n| `PROVIDER_TYPE_UNSPECIFIED` | Not specified. |\n| `MERCHANT` | A 1P provider such as a merchant, or an agency on behalf of a merchant. |\n| `AGGREGATOR_3P` | A 3P aggregator, such as a `Reserve with Google` partner. |\n\nPlaceActionType\n---------------\n\nThe type of place action that can be performed using the link.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------|\n| `PLACE_ACTION_TYPE_UNSPECIFIED` | Not specified. |\n| `APPOINTMENT` | The action type is booking an appointment. |\n| `ONLINE_APPOINTMENT` | The action type is booking an online appointment. |\n| `DINING_RESERVATION` | The action type is making a dining reservation. |\n| `FOOD_ORDERING` | The action type is ordering food for delivery and/or takeout. |\n| `FOOD_DELIVERY` | The action type is ordering food for delivery. |\n| `FOOD_TAKEOUT` | The action type is ordering food for takeout. |\n| `SHOP_ONLINE` | The action type is shopping, that can be delivery and/or pickup. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/create) | Creates a place action link associated with the specified location, and returns it. |\n| ### [delete](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/delete) | Deletes a place action link from the specified location. |\n| ### [get](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/get) | Gets the specified place action link. |\n| ### [list](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/list) | Lists the place action links for the specified location. |\n| ### [patch](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/patch) | Updates the specified place action link and returns it. |"]]
