Trang này được dịch bởi Cloud Translation API.

Thao tác trong Play Games

Tổng quan

Tài liệu này giới thiệu về Thao tác trong Play Games cho trò chơi điện tử, liệt kê các yêu cầu về giản đồ và trình bày chi tiết quy trình tham gia để ra mắt tính năng này.

Giới thiệu về Thao tác trên Play Games

Hình ảnh về các thao tác trong Play Games trên thiết bị di động

Phiên bản dành cho máy tính của Play Game Actions

Hình ảnh về các thao tác trong Play Games trên máy tính

Tính năng Thao tác với trò chơi trên Play cho phép người dùng chơi trò chơi ngay trên Trang kết quả tìm kiếm (SRP) trên máy tính hoặc thiết bị di động. Người dùng sẽ thấy một Thao tác Play Games trong thẻ Tổng quan của Trang kết quả tìm kiếm có tổ chức (OSRP) hoặc trong Bảng tri thức khi họ tìm kiếm một trò chơi có ít nhất một Thao tác Play Games được liên kết. Điều này áp dụng cho phiên bản dùng thử hoặc phiên bản đầy đủ của những trò chơi được cung cấp miễn phí, thông qua gói thuê bao hoặc mua riêng lẻ và có thể phát trực tuyến từ đám mây trên máy tính hoặc thiết bị di động, hoặc có thể tải xuống thông qua ứng dụng cục bộ trên máy tính hoặc bảng điều khiển.

Play Game Actions được hỗ trợ bởi một nguồn cấp dữ liệu chứa thông tin chi tiết về danh mục trò chơi của bạn. Nguồn cấp dữ liệu là một đối tượng JSON chứa một tập hợp các thực thể. Thực thể là một đối tượng schema.org đại diện cho trò chơi trong danh mục của bạn và đường liên kết sâu được liên kết để phát trực tuyến trò chơi (bản minh hoạ, bản dùng thử tức thì hoặc phiên bản đầy đủ).

Để Google nhận được nguồn cấp dữ liệu của bạn, bạn cần lưu trữ nguồn cấp dữ liệu trong một tệp và lưu trữ tệp đó ở một vị trí mà Google có thể truy cập. Để đảm bảo nội dung của bạn luôn mới nhất, Google thường xuyên tìm nạp tệp nguồn cấp dữ liệu từ máy chủ lưu trữ của bạn.

Chúng tôi sẽ trình bày chi tiết từng yêu cầu này trong các phần sau.

Bắt đầu

Như phần trước đã nêu, trách nhiệm của bạn với tư cách là nhà cung cấp bao gồm những việc sau:

Hiểu rõ thông tin bạn cần để tạo nguồn cấp dữ liệu; nguồn và tính sẵn có của thông tin đó, cũng như cách thông tin xuất hiện trong nguồn cấp dữ liệu.
Tạo một nguồn cấp dữ liệu chứa thông tin bắt buộc của từng thực thể trò chơi trong danh mục của bạn.
Lưu trữ nguồn cấp dữ liệu trên một máy chủ hoặc dịch vụ lưu trữ đám mây và cho phép Google thường xuyên tìm nạp nguồn cấp dữ liệu.
Trả lời và khắc phục các vấn đề do Google nêu ra. Đây có thể là các vấn đề liên quan đến chất lượng hoặc các vấn đề liên quan đến cấu trúc của chính tệp JSON.
Luôn cập nhật nguồn cấp dữ liệu khi danh mục của bạn thay đổi.
Đảm bảo chất lượng nguồn cấp dữ liệu được duy trì sau khi ra mắt.

Hãy cùng tìm hiểu chi tiết về những điều này.

Trước khi bắt đầu

Trước khi bắt đầu tạo nguồn cấp dữ liệu, bạn nên dành thời gian tìm hiểu các yêu cầu về siêu dữ liệu của Thao tác trong trò chơi trên Play và thu thập tất cả thông tin cần thiết ở một nơi. Bạn nên làm theo những bước sau trước khi bắt đầu tạo nguồn cấp dữ liệu:

Xem các yêu cầu về siêu dữ liệu đối với thực thể VideoGame.
Thu thập siêu dữ liệu.
- Hãy xem xét kỹ các thuộc tính bắt buộc và rất nên dùng. Google sử dụng các thuộc tính này để đối chiếu nội dung của bạn trong nguồn cấp dữ liệu với nội dung trong cơ sở dữ liệu của Google; bạn cung cấp càng nhiều siêu dữ liệu cho nội dung của mình, thì Google càng có thể so khớp nội dung đó một cách hiệu quả hơn.

Hiểu cách sử dụng các khái niệm Tác phẩm và Ấn phẩm trong tài liệu này

Tác phẩm: Khái niệm trừu tượng về một trò chơi điện tử. Cụ thể, siêu dữ liệu như tiêu đề, nhà phát triển, nội dung mô tả trò chơi và nhà xuất bản là các thuộc tính của một tác phẩm.
Ấn bản: Một phiên bản hữu hình của trò chơi điện tử. Cụ thể, siêu dữ liệu như năm xuất bản, tên nền tảng và đường liên kết sâu là các thuộc tính của ấn bản.

Ví dụ: "Shadow of the Tomb Raider" là một tác phẩm, nhưng mọi phiên bản của tác phẩm này đều là ấn bản. Trong trường hợp này, tác phẩm "Shadow of the Tomb Raider" có thể có một phiên bản dành cho Stadia, một phiên bản dành cho PlayStation, một phiên bản dành cho Early Access trên Stadia, v.v.

Trong nguồn cấp dữ liệu, sự khác biệt này đặc biệt quan trọng nhưng lại khó nhận ra. Có hai thực thể VideoGame:

VideoGame (Tác phẩm) là thực thể VideoGame "cấp cao nhất":

exampleOfWork là một thuộc tính của VideoGame (Work) và chỉ định một hoặc nhiều phiên bản của VideoGame (Edition).
Phải có ít nhất một exampleOfWork VideoGame (Edition) cho mỗi VideoGame (Work).

VideoGame (Edition) là thực thể VideoGame "cấp thấp hơn".

Hãy nhớ rằng một tác phẩm có thể có nhiều ấn bản. Bạn nên tạo nhiều nhóm nhất có thể cho các ấn bản này. Điều này giúp các hệ thống của Google tận dụng tất cả thông tin liên quan về một VideoGame và trình bày VideoGame đó trong Tìm kiếm.

Tìm hiểu 2 thuộc tính chính và các yêu cầu của chúng. Bạn cần phải nhập chính xác những thông tin này khi chuyển sang bước tiếp theo là tạo nguồn cấp dữ liệu.

URL chuẩn (url)

URL chính tắc (url) giúp Google điều chỉnh nội dung trong danh mục của bạn sao cho khớp với nội dung trong cơ sở dữ liệu của Google.

"URL chính tắc là URL của trang mà Google đánh giá là tiêu biểu nhất trong số những trang trùng lặp trên trang web của bạn. Ví dụ: nếu bạn có nhiều URL cho cùng một trang (ví dụ: example.com?dress=1234 và example.com/dresses/1234), thì Google sẽ chọn một URL trong số đó làm URL chính tắc." (Nguồn: Hợp nhất các URL trùng lặp)

Sau đây là các yêu cầu đối với URL chuẩn:

url phải là duy nhất trên toàn hệ thống.
url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.

Giá trị nhận dạng (@id)

Giá trị nhận dạng (@id) phải đáp ứng các yêu cầu sau:

Là giá trị duy nhất trên toàn cầu trong danh mục của bạn:
- Ví dụ: đừng sử dụng cùng một @id cho hai trò chơi điện tử khác nhau.
Tĩnh:
- Sau này, bạn không thể thay đổi @id.
Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI):
- Nếu mã nhận dạng (ID) cục bộ của nội dung không ở định dạng URI, hãy thêm miền của bạn vào trước mã nhận dạng để đáp ứng yêu cầu này; ví dụ: nếu mã nhận dạng của nội dung là 1234abc và miền của bạn là https://example.com, thì @id có thể là https://example.com/1234abc.
- @id không bắt buộc phải là một URL đang hoạt động; URL này chỉ cần có định dạng URI.
- Miền được dùng trong @id (ví dụ: https://example.com) phải thuộc sở hữu của tổ chức của bạn.

Vì url của một thực thể đáp ứng mọi yêu cầu về mã nhận dạng (tức là duy nhất trên toàn cầu, tĩnh và ở dạng URI), nên bạn nên sử dụng url của một thực thể làm @id trong những trường hợp hợp lý.

Hiểu và xác định các yêu cầu về đường liên kết sâu

Khi người dùng bắt đầu Hành động trong Play Games trên nội dung, Google sẽ sử dụng đường liên kết sâu của nội dung đó để đưa người dùng đến thẳng nội dung trong ứng dụng hoặc nền tảng của bạn. Những điều cần lưu ý:

Đường liên kết sâu cần mở nội dung mà đường liên kết đó nhắm đến trên tất cả các nền tảng được chỉ định. Các nền tảng khác nhau có thể có các đường liên kết sâu khác nhau. Ví dụ: đường liên kết sâu hoạt động trên web dành cho máy tính có thể khác với đường liên kết sâu hoạt động trên web dành cho thiết bị di động. Đối với mỗi trò chơi, hãy kiểm tra xem trò chơi đó có các đường liên kết sâu khác nhau dựa trên nền tảng hay không.
Đường liên kết sâu có thể bao gồm các tham số (&) hoặc thẻ liên kết (#).
Để đảm bảo nội dung của bạn có trên nhiều nền tảng của Google (Tìm kiếm, Trợ lý và Android TV), bạn cần phải có một đường liên kết sâu.

Vì url của một thực thể đáp ứng tất cả các yêu cầu của một mã nhận dạng (tức là duy nhất trên toàn cầu, tĩnh và ở dạng URI), nên bạn nên sử dụng url của một thực thể làm @id trong những trường hợp hợp lý.

Nền tảng	Mô tả
http://schema.org/DesktopWebPlatform	Nền tảng tìm kiếm trên trình duyệt web dành cho máy tính.
http://schema.org/MobileWebPlatform	Nền tảng tìm kiếm trên trình duyệt web dành cho thiết bị di động.
http://schema.org/AndroidPlatform	Nền tảng tìm kiếm trên ứng dụng Android.
http://schema.org/AndroidTVPlatform	Nền tảng Android TV trên ứng dụng Android TV.
http://schema.org/IOSPlatform	Nền tảng tìm kiếm trên ứng dụng iOS.

Xác định các yêu cầu về quyền truy cập đối với các trò chơi trong danh mục của bạn: Tự hỏi bản thân những câu hỏi sau và đảm bảo có cách xác định câu trả lời thông qua siêu dữ liệu trong nguồn cấp dữ liệu.

Người dùng có cần đăng nhập vào ứng dụng hoặc nền tảng của bạn để truy cập nội dung không?
Người dùng có cần đăng ký gói thuê bao không?
Người dùng có cần mua hàng để chơi trò chơi không?
Yêu cầu về quyền truy cập có thay đổi theo thời gian không?
Yêu cầu truy cập có phụ thuộc vào vị trí của thiết bị không?

Nếu bạn cung cấp nhiều gói thuê bao mà người dùng có thể mua, hãy tìm hiểu commonTier là gì và cách áp dụng gói đó cho việc tích hợp của bạn với Google.

Các loại tường phí

Hành động trong Play Games hiện chỉ hỗ trợ những loại tường phí sau đây:

Giá trị danh mục	Loại tường phí
`nologinrequired`	Không cần mua hàng hay đăng nhập.
`free`	Người dùng phải đăng nhập nhưng không cần có gói thuê bao trả phí.
`subscription` Lưu ý: Bạn phải sử dụng mã đánh dấu cấp phổ biến.	Người dùng phải có một gói thuê bao đang hoạt động. Quyền truy cập không phụ thuộc vào gói thuê bao.
`subscription` Lưu ý: Chỉ định tập hợp giá trị nhận dạng quyền cần thiết để truy cập vào nội dung này bằng `MediaSubscription.identifier`. Để biết thêm thông tin, hãy xem bài viết Mã nhận dạng quyền. Bạn có thể cần phải sử dụng mã đánh dấu cấp phổ biến.	Người dùng phải có một gói thuê bao đang hoạt động. Quyền truy cập không phụ thuộc vào gói thuê bao.
`purchase`	Bạn có thể xem nội dung đã mua trong thời gian không giới hạn.
`rental`	Nội dung được cung cấp trong một khoảng thời gian nhất định sau khi mua.

Các giá trị danh mục này sẽ được sử dụng sau này khi tạo nguồn cấp dữ liệu. Ngoài ra, hãy lưu ý rằng danh mục rental trong bảng trước hoàn toàn không bắt buộc hiện tại và có thể được hỗ trợ trong một lần cải tiến sản phẩm trong tương lai. Hiện tại, sản phẩm chỉ tận dụng các giá trị danh mục free, nologinrequired, subscription và purchase trong nguồn cấp dữ liệu.

Cuối cùng, hãy xem nhanh nguồn cấp dữ liệu mẫu để biết được những gì chúng ta muốn đạt được.

Hiểu rõ những điều trên và đảm bảo có siêu dữ liệu để thể hiện câu trả lời (cho những câu hỏi này), đủ để chuyển sang giai đoạn tạo nguồn cấp dữ liệu.

Tạo nguồn cấp dữ liệu

Nguồn cấp dữ liệu Play Game Actions là một đối tượng JSON chứa một tập hợp các thực thể đại diện cho trò chơi điện tử trong danh mục của bạn. Bạn cần cung cấp một nguồn cấp dữ liệu dưới dạng một tệp hoặc nhiều tệp và lưu trữ tệp đó trên một máy chủ hoặc dịch vụ lưu trữ đám mây để Google thường xuyên tìm nạp.

Tuân thủ yêu cầu về kích thước, số lượng và định dạng của tệp nguồn cấp dữ liệu

Bạn cần tuân thủ các yêu cầu sau:

Tất cả các tệp nguồn cấp dữ liệu đều cần sử dụng đuôi tệp .json.
Đảm bảo rằng tên tệp không chứa dấu cách.
Không mã hoá tệp nguồn cấp dữ liệu.
Mã hoá tệp nguồn cấp dữ liệu bằng UTF-8 (kiểm tra chế độ cài đặt trình chỉnh sửa tệp).
Nếu tệp nguồn cấp dữ liệu của bạn lớn hơn 1 GB khi chưa nén, hãy chia tệp đó thành nhiều tệp.
- Miễn là kích thước tệp nhỏ hơn 1 GB, bạn có thể đưa bao nhiêu thực thể tuỳ ý vào một tệp hoặc gửi bao nhiêu tệp tuỳ ý cho Google trong quá trình gửi nguồn cấp dữ liệu.
Đảm bảo rằng tệp được mã hoá mà không có BOM, theo quy cách JSON. Để xác minh điều này trên hệ điều hành Linux, hexdump file.json | head -n 1 không được bắt đầu bằng BBEF tại địa chỉ 0x00.

Tuân thủ các yêu cầu về nội dung nguồn cấp dữ liệu

Bạn phải tuân thủ các yêu cầu sau đây về nội dung:

Nguồn cấp dữ liệu không được chứa các thực thể cũ. Các thực thể cũ là những thực thể có availabilityEnds của đường liên kết sâu được đặt thành một ngày trong quá khứ hoặc những thực thể không còn xuất hiện trên trang web của bạn nữa.
Tất cả đường liên kết sâu (chẳng hạn như urlTemplate) và tất cả URL (chẳng hạn như url) mà bạn đưa vào nguồn cấp dữ liệu phải là URL chính thức. Đừng sử dụng URL đang trong quy trình đảm bảo chất lượng, URL đang phát triển hoặc các loại URL chưa chính thức khác.
Tất cả URL, chẳng hạn như url, đều phải là URL chính tắc, như phần trước đã đề cập.
Mỗi thực thể trong nguồn cấp dữ liệu của bạn phải chỉ định các thuộc tính sau:
- Một giá trị nhận dạng duy nhất: @id
- Một URL duy nhất: url
- Một đường liên kết sâu duy nhất: urlTemplate

Bạn nên làm theo những đề xuất sau khi tạo nguồn cấp dữ liệu:

Hiểu rõ cách cấu trúc nguồn cấp dữ liệu.
Bắt đầu bằng một nguồn cấp dữ liệu mẫu.
- Chọn tối đa 5 thực thể đại diện trong danh mục của bạn. Chọn các thực thể có cấu trúc tương đối phức tạp nhưng vẫn điển hình cho một thực thể trong danh mục và tạo nguồn cấp dữ liệu cho thực thể đó.
Hãy gửi thông tin này cho người đại diện được chỉ định của Google để xác thực nhanh.
Sau khi bạn giải quyết tất cả các lỗi trong nguồn cấp dữ liệu mẫu, hãy mở rộng nguồn cấp dữ liệu để bao gồm tất cả các thực thể trong danh mục của bạn.
- Để xác nhận rằng nguồn cấp dữ liệu của bạn có tất cả các thực thể trong danh mục, hãy so sánh số lượng thực thể trong nguồn cấp dữ liệu với số lượng mặt hàng trong danh mục.

Lưu trữ nguồn cấp dữ liệu

Khi tệp nguồn cấp dữ liệu của bạn đã sẵn sàng, hãy lưu trữ tệp tại một vị trí an toàn. Sau đó, Google thường xuyên tìm nạp nguồn cấp dữ liệu để đảm bảo rằng nội dung của bạn được cập nhật. Chúng tôi hỗ trợ các phương thức lưu trữ sau:

Phương thức lưu trữ	Hỗ trợ xác thực
Google Cloud Storage	Cấp quyền Storage Object Viewer (Xem đối tượng lưu trữ) cho `088794101-100000002-account@partnercontent.gserviceaccount.com`
HTTPS	Yêu cầu bạn chia sẻ Tên người dùng + Mật khẩu hoặc chứng chỉ máy khách HTTP.
SFTP	Yêu cầu bạn chia sẻ Mật khẩu, Khoá + cụm từ hoặc cả hai.
AWS S3	Bạn cần chia sẻ Mã khoá + Khoá truy cập cho bộ chứa AWS S3.

Sau khi bạn tải tệp nguồn cấp dữ liệu lên một hệ thống lưu trữ, hãy liên hệ với nhóm Play Game Actions để xem xét tệp nguồn cấp dữ liệu của bạn.

Gửi nguồn cấp dữ liệu để xem xét

Sau khi tệp nguồn cấp dữ liệu được lưu trữ, hãy liên hệ với người liên hệ được chỉ định của bạn trong Play Game Actions để bắt đầu quy trình xem xét nguồn cấp dữ liệu. Hãy nhớ chia sẻ những thông tin sau trong nội dung liên hệ này:

Tổng quan/Nội dung mô tả: Cho chúng tôi biết bạn đang chia sẻ nguồn cấp dữ liệu mẫu hay nguồn cấp dữ liệu sản xuất đầy đủ. Nếu bạn chia sẻ nguồn cấp dữ liệu mẫu, vui lòng cho chúng tôi biết thời gian dự kiến có nguồn cấp dữ liệu sản xuất (nếu có thể).
Vị trí lưu trữ: URL của tệp nguồn cấp dữ liệu.
Xác thực máy chủ lưu trữ: Thêm thông tin xác thực để cho phép Google truy xuất tệp nguồn cấp dữ liệu từ máy chủ lưu trữ của bạn (nếu có). Để biết thêm thông tin, hãy xem phần Lưu trữ nguồn cấp dữ liệu.
Tài khoản kiểm thử: Tài khoản kiểm thử cho phép nhóm Play Game Actions truy cập vào đường liên kết sâu trên ứng dụng hoặc nền tảng của bạn để kiểm thử. Nếu nguồn cấp dữ liệu của bạn có các thực thể trên nhiều nền tảng, hãy cung cấp một tài khoản kiểm thử cho mỗi nền tảng.
Icons: Gửi 5 biểu tượng sau. Các biểu tượng này được dùng bên cạnh các Hành động trong Play Games trên Mạng Tìm kiếm.

Danh mục	Kích thước (pixel)	Kích thước tệp	Nguyên tắc
Hành động trong Play Games trên Tìm kiếm/Truyền/Các nền tảng khác
	16x16	Kích thước tệp của tất cả biểu tượng, ngoại trừ biểu tượng 112x112 px, không được lớn hơn 1 KB. Kích thước tệp của biểu tượng 112x112 px không được lớn hơn 3 KB.	Bạn phải cung cấp cả 5 kích thước biểu tượng. Hình ảnh phải tuân thủ những yêu cầu sau: Định dạng tệp PNG. Hình tròn. Nền trong suốt. Đảm bảo hình ảnh được khử răng cưa và không bị biến dạng hoặc bị vỡ hạt.
	20x20
	40x40
	44x44
	112x112

Mẫu

Cách hoạt động của quy trình xác thực nguồn cấp dữ liệu

Có 2 giai đoạn xác thực nguồn cấp dữ liệu:

Xác thực cấu trúc:
- Đây là giai đoạn đầu tiên của quy trình kiểm tra xác thực.
- Google cung cấp ý kiến phản hồi liên quan đến cấu trúc của tệp JSON. JSON có được định dạng đúng không? Chúng ta có tất cả các thuộc tính bắt buộc và thuộc tính rất nên dùng trong nguồn cấp dữ liệu không? Bạn có cung cấp và chú thích đường liên kết sâu theo yêu cầu về nguồn cấp dữ liệu của chúng tôi không?
- Giai đoạn này đòi hỏi bạn phải trao đổi nhiều lần với Google và tiếp tục cho đến khi tất cả ý kiến phản hồi được giải quyết.
Đối chiếu siêu dữ liệu:
- Quá trình này chỉ bắt đầu sau khi nguồn cấp dữ liệu vượt qua giai đoạn xác thực cấu trúc và đây là thời điểm Google bắt đầu quy trình đối chiếu với Sơ đồ tri thức của Google.
- Trong giai đoạn này, chúng tôi sẽ cung cấp ý kiến phản hồi về siêu dữ liệu có trong nguồn cấp dữ liệu. Bạn cần giải quyết tất cả vấn đề để có thể ra mắt thành công. Ví dụ: ý kiến phản hồi trong giai đoạn này có thể yêu cầu bạn sửa tiêu đề của một trò chơi hoặc ngày phát hành của trò chơi đó.
- Giai đoạn này cũng đòi hỏi nhiều cuộc thảo luận qua lại với Google và tiếp tục cho đến khi tất cả ý kiến phản hồi được giải quyết.

Tiêu chí chấp nhận nguồn cấp dữ liệu

Nguồn cấp dữ liệu được coi là chấp nhận được để ra mắt khi tất cả vấn đề cần ngăn chặn đều được giải quyết và Google đã chứng nhận chất lượng siêu dữ liệu đạt mức tối thiểu để ra mắt.

Cập nhật nguồn cấp dữ liệu nếu cần

Bạn nên cập nhật nguồn cấp dữ liệu hằng ngày, nhưng sau cùng thì việc này vẫn phụ thuộc vào tần suất thay đổi của danh mục sách. Hãy lưu ý các điều kiện và mẹo sau:

Google Tìm kiếm không hỗ trợ cập nhật theo thời gian thực.
Google Tìm kiếm sẽ tìm nạp nguồn cấp dữ liệu của bạn một lần mỗi ngày và thường tiến hành lập chỉ mục nội dung trong vòng hai ngày (khi ra mắt).
Nếu bạn dự định thay đổi thời gian mà người dùng có thể đọc một đường liên kết sâu, hãy dùng availabilityStarts và availabilityEnds để đặt ngày chính xác.
Nếu thực thể không còn trong danh mục của bạn, hãy xoá hoàn toàn thực thể đó khỏi nguồn cấp dữ liệu.

Tài liệu tham khảo

Tổng quan về cấu trúc nguồn cấp dữ liệu

Nguồn cấp dữ liệu Thao tác trong Play Games có cấu trúc như sau:

Phong bì nguồn cấp dữ liệu

Bao thư nguồn cấp dữ liệu là đối tượng cấp cao nhất trong nguồn cấp dữ liệu Thao tác trong Play Games. Đối tượng này chứa một mảng các đối tượng đánh dấu nội dung (thực thể VideoGame (Work)) đại diện cho tất cả các trò chơi điện tử trong danh mục của bạn.

Thuộc tính	Loại dự kiến	Mô tả
`@context`	URL	Bắt buộc. Đặt thành `http://schema.org`
`@type`	Văn bản	Bắt buộc. Thiết lập thành `DataFeed`.
`dateModified`	DateTime	Bắt buộc. Ngày và giờ sửa đổi nguồn cấp dữ liệu lần gần đây nhất, ở định dạng ISO 8601 (bao gồm cả múi giờ).
`dataFeedElement`	Thing	Bắt buộc. Các thực thể trong danh mục trò chơi của bạn.

Mẫu

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {  },
    {  },
    ...
  ]
}

Đối tượng đánh dấu nội dung

Đối tượng đánh dấu nội dung đại diện cho một thực thể trong danh mục của bạn: VideoGame (Work). Đối tượng này chứa giá trị nhận dạng và URL chuẩn của nội dung, đồng thời giúp mô tả nội dung thông qua siêu dữ liệu. Đối tượng đánh dấu nội dung cho VideoGame (Work) có một thuộc tính gọi là exampleOfWork để liên kết đối tượng này với đối tượng VideoGame(Edition). VideoGame(Edition) này có thể có một mảng các đối tượng đánh dấu Action, cho phép nội dung được liên kết với nhiều đối tượng đánh dấu Action. Ví dụ: nội dung có thể có một đối tượng đánh dấu Hành động khác nhau cho từng khu vực.

Đối tượng đánh dấu hành động

Đối tượng đánh dấu Thao tác mô tả đường liên kết sâu đưa người dùng đến trò chơi và cấp độ truy cập cần thiết cho trò chơi. Đối tượng này là một thuộc tính (potentialAction) của đối tượng đánh dấu nội dung. Đối với Play Game Actions, hãy sử dụng một đối tượng chỉ định quyền truy cập vào Hành động để chỉ định các quy định hạn chế về quyền truy cập.

Thuộc tính	Loại dự kiến	Mô tả
`@type`	Văn bản	Bắt buộc. Luôn đặt thành `PlayGameAction`.
`gameAvailabilityType`	GameAvailabilityEnumeration hoặc Text	Bắt buộc. Cho biết loại tình trạng còn hàng của nội dung trò chơi liên quan đến hành động này, chẳng hạn như phiên bản đầy đủ hay bản dùng thử. Giá trị được chấp nhận bao gồm `DEMO` và `FULL`.
`additionalType`	Văn bản	Bắt buộc. Cho biết loại hành động phát liên kết với trò chơi này. Các giá trị được chấp nhận bao gồm: `StreamingPlayAction` – Cho biết rằng bạn có thể phát trực tuyến một trận đấu trên mạng `DownloadPlayAction` – Cho biết rằng bạn có thể tải một trò chơi xuống
`target`	EntryPoint	Bắt buộc. Một đối tượng đích cung cấp mối liên kết giữa các đường liên kết sâu với nhiều nền tảng của Google.
`target.@type`	Văn bản	Bắt buộc. Luôn đặt thành `EntryPoint`.
`target.urlTemplate`	URL	Bắt buộc. Một đường liên kết sâu đưa người dùng đến ứng dụng hoặc nền tảng của bạn và bắt đầu phát trò chơi.
`target.inLanguage`	Văn bản	Không bắt buộc. Ngôn ngữ gốc của bộ phim ở định dạng BCP 47.
`target.actionPlatform`	Văn bản	Bắt buộc. Các nền tảng được liên kết với `urlTemplate`. Hành động trong Play Games hỗ trợ các giá trị sau: http://schema.org/DesktopWebPlatform http://schema.org/MobileWebPlatform http://schema.org/AndroidPlatform http://schema.org/AndroidTVPlatform http://schema.org/IOSPlatform Để biết các yêu cầu, hãy xem phần Các loại nền tảng.
`actionAccessibilityRequirement`	ActionAccessSpecification	Bắt buộc. Một Đối tượng chỉ định quyền truy cập vào hành động mô tả yêu cầu truy cập vào nội dung. Để biết thông tin chi tiết, hãy xem phần Các thuộc tính của quy cách về quyền truy cập vào hành động.

Mẫu

"potentialAction": {
  "@type": "PlayGameAction",
  "target": [
    {  },
    {  }
  ],
  "actionAccessibilityRequirement": [
    {  },
    {  }
  ]
}

Mục tiêu

Đối tượng đích cung cấp thông tin ánh xạ của một đường liên kết sâu đến nhiều nền tảng của Google. Đối tượng này là một thuộc tính (target) của đối tượng Đánh dấu hành động. Thuộc tính urlTemplate ghi lại đường liên kết sâu và actionPlatform ghi lại các nền tảng hỗ trợ đường liên kết sâu.

Ví dụ:

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

Quy cách về quyền truy cập vào hành động

Đối tượng chỉ định quyền truy cập vào Hành động mô tả yêu cầu truy cập đối với nội dung dựa trên khu vực và khoảng thời gian. Đối tượng này là một thuộc tính, actionAccessibilityRequirement, của đối tượng Action markup.

Ví dụ về Mục tiêu có 2 đường liên kết sâu

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

Quy cách về quyền truy cập vào hành động

Thuộc tính	Loại dự kiến	Mô tả
`actionAccessibilityRequirement.@type`	Văn bản	Bắt buộc. Luôn đặt thành `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	Văn bản	Bắt buộc. Yêu cầu về quyền truy cập đối với nội dung. Để biết các giá trị được chấp nhận và thông tin khác, hãy xem phần Loại tường phí. Nếu một thực thể đại diện cho một nhóm nội dung, bạn cần đặt danh mục thành yêu cầu truy cập ít hạn chế nhất đối với nội dung của thực thể đó. Ví dụ: nếu một trò chơi có thể truy cập miễn phí bằng cách sử dụng `nologinrequired` và thông qua gói thuê bao, hãy đặt danh mục thành `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	Ngày	Bắt buộc. Ngày mà sau đó hành động này sẽ có hiệu lực, ở định dạng ISO 8601 (bao gồm cả múi giờ). Bạn có thể đặt ngày trong tương lai. Phải bằng hoặc lớn hơn 72 giờ sau `availabilityStarts`. Nếu nội dung luôn có sẵn sau khi xuất bản, hãy đặt ngày này là 20 năm kể từ ngày hiện tại. Bạn phải cung cấp thực thể tương ứng trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày `availabilityStarts`. Điều này giúp tăng khả năng trò chơi xuất hiện trên các nền tảng của Google đúng thời gian.
`actionAccessibilityRequirement.availabilityEnds`	Ngày	Bắt buộc. Ngày mà sau đó hành động này sẽ không còn thực hiện được nữa, ở định dạng ISO 8601 (bao gồm cả múi giờ). Bạn có thể đặt ngày trong tương lai. Phải bằng hoặc lớn hơn 72 giờ sau `availabilityStarts`. Nếu nội dung luôn có sẵn sau khi xuất bản, hãy đặt ngày này là 20 năm kể từ ngày hiện tại. Bạn phải cập nhật ngày `availabilityEnds` trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày `availabilityEnds`. Điều này giúp tăng khả năng trò chơi ngừng xuất hiện trên các nền tảng của Google vào ngày `availabilityEnds`.
`actionAccessibilityRequirement.eligibleRegion`	Country, City, State, GeoShape hoặc Text	Bắt buộc. Khu vực nơi nội dung được cung cấp. Nếu nội dung có trên toàn cầu, hãy sử dụng chuỗi đặc biệt `EARTH`. Để hiểu rõ những thông tin bắt buộc, hãy xem các thuộc tính GeoShape.
`actionAccessibilityRequirement.ineligibleRegion`	Country, City, State, GeoShape hoặc Text	Bắt buộc nếu áp dụng. Khu vực nơi nội dung bị hạn chế. Bạn không cần cung cấp thuộc tính này nếu nội dung có ở mọi nơi trong `eligibleRegion`. Để hiểu rõ những thông tin bắt buộc, hãy xem các thuộc tính GeoShape.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	Bắt buộc nếu áp dụng. Thông tin chi tiết về gói thuê bao mà người dùng cần có để truy cập vào nội dung. Để biết thông tin chi tiết, hãy xem phần Thuộc tính gói thuê bao nội dung nghe nhìn. Cung cấp thuộc tính này nếu `category` là `subscription`.
`actionAccessibilityRequirement.expectsAcceptanceOf`	Ưu đãi	Bắt buộc nếu nội dung yêu cầu phải mua. Thông tin chi tiết về ưu đãi liên quan đến nội dung. Cung cấp thông tin về giá cho các trường hợp sau: Nội dung mua một lần (`rental` hoặc `purchase`) Nội dung dựa trên gói thuê bao mà người đăng ký phải mua thêm (`subscription`) Nếu giá là 0,00, hãy xoá hoàn toàn đối tượng Offer và đặt `actionAccessibilityRequirement.category` thành `free`. Để biết thêm thông tin, hãy xem Thuộc tính của ưu đãi.

Quy cách về gói thuê bao nội dung nghe nhìn

Đối tượng gói thuê bao nội dung nghe nhìn mô tả thông tin chi tiết về gói thuê bao cần thiết cho nội dung. Đối tượng này là một thuộc tính, requiresSubscription, của một Đối tượng chỉ định quyền truy cập vào hành động.

Quan trọng: Bạn phải cung cấp thông tin này nếu actionAccessibilityRequirement.category là subscription và gói thuê bao của bạn có nhiều gói hoặc cấp, hoặc có hỗ trợ tiện ích bổ sung. Bỏ qua thông tin này nếu gói thuê bao của bạn chỉ có một cấp và cho phép truy cập vào tất cả nội dung trong danh mục.

Thuộc tính	Loại dự kiến	Mô tả
`requiresSubscription.@type`	Văn bản	Bắt buộc. Luôn đặt thành `MediaSubscription`.
`requiresSubscription.@id`	URL	Bắt buộc. Mã nhận dạng duy nhất của gói thuê bao. Nếu nội dung có thể truy cập bằng nhiều gói thuê bao, thì mỗi gói thuê bao phải có một mã nhận dạng riêng biệt.
`requiresSubscription.name`	Văn bản	Bắt buộc. Tên của gói thuê bao. Xin lưu ý những điều sau: Nếu nội dung có thể truy cập bằng nhiều gói thuê bao, thì tên này phải khớp với tên trong hệ thống xác thực người dùng của bạn. Ví dụ: nếu người dùng có thể truy cập vào nội dung dựa trên gói thuê bao có tên là Gói 1, nhưng hệ thống xác thực sử dụng tên PKG1, hãy dùng PKG1.
`requiresSubscription.sameAs`	URL	Không bắt buộc. Trang mô tả gói thuê bao.
`requiresSubscription.identifier`	Văn bản	Bắt buộc nếu `category` là `subscription` và `commonTier` là false. Một chuỗi duy nhất cho gói thuê bao này, đại diện cho quyền truy cập vào một nhóm nội dung trong danh mục nội dung nghe nhìn của bạn. Google đề xuất bạn sử dụng cú pháp sau cho `identifier`:tên miền + dấu hai chấm (:) + cấp độ truy cập vào nội dung, Ví dụ : `example.com`:cơ bản, `example.com:premium`, `example.com:sports`
`requiresSubscription.commonTier`	Boolean	Bắt buộc nếu danh mục được đặt thành gói thuê bao. Đọc thêm về `commonTier` trong tài liệu các yêu cầu chung về cấp.

Thuộc tính của ưu đãi

Đối tượng ưu đãi mô tả giá liên quan đến nội dung. Đối tượng này là một thuộc tính (expectsAcceptanceOf) của Đối tượng chỉ định quyền truy cập vào thao tác. Bạn có thể sử dụng tính năng này cho 2 mục đích:

Để cung cấp thông tin chi tiết về giao dịch mua trò chơi. Bạn nên đặt actionAccessibilityRequirement.category thành purchase cho trường hợp sử dụng này.
Để cung cấp thông tin chi tiết về giao dịch mua trò chơi khi trò chơi được bán. actionAccessibilityRequirement.category phải được đặt thành purchase cho trường hợp sử dụng này và bạn phải cung cấp 2 mặt hàng cho mỗi hành động – một mặt hàng để cung cấp thông tin chi tiết về giá niêm yết và một mặt hàng khác để cung cấp thông tin chi tiết về giá ưu đãi.

Thuộc tính	Loại dự kiến	Mô tả
`expectsAcceptanceOf.@type`	Văn bản	Bắt buộc – Luôn đặt thành `Offer`.
`expectsAcceptanceOf.name`	Văn bản	Không bắt buộc – Tên của ưu đãi.
`expectsAcceptanceOf.priceSpecification`	PriceSpecification	Bắt buộc – Thông tin chi tiết về giá liên quan đến trò chơi.
`expectsAcceptanceOf.priceSpecification.@type`	Văn bản	Bắt buộc – Luôn đặt thành `UnitPriceSpecification`.
`expectsAcceptanceOf.priceSpecification.price`	Number	Bắt buộc – Giá mua nội dung. Giá phải là giá trị dương khác 0. Đối với những trò chơi có giá 0,00, vui lòng đặt `actionAccessibilityRequirement.category` thành "free".
`expectsAcceptanceOf.priceSpecification.priceCurrency`	Văn bản	Bắt buộc – Đơn vị tiền tệ của giá ở định dạng ISO 4217 gồm 3 chữ cái.
`expectsAcceptanceOf.priceSpecification.priceType`	PriceTypeEnumeration hoặc Text	Bắt buộc nếu có – Loại giá được cung cấp trong ưu đãi. Khi `actionAccessibilityRequirement.category` được đặt thành `purchase`, đây là một thuộc tính bắt buộc và chỉ có thể chấp nhận 2 giá trị: `https://schema.org/ListPrice` – Đại diện cho giá niêm yết của một trò chơi. `https://schema.org/SalePrice` – Thể hiện giá ưu đãi (thường có hiệu lực trong một khoảng thời gian giới hạn) của một trò chơi. Bạn phải cung cấp cả `https://schema.org/ListPrice` và `https://schema.org/SalePrice` khi cung cấp thông tin chi tiết về giá ưu đãi.
`expectsAcceptanceOf.seller`	Tổ chức	Tổ chức cung cấp nội dung để mua.
`expectsAcceptanceOf.seller.@type`	Văn bản	Luôn đặt thành `Organization`.
`expectsAcceptanceOf.seller.name`	Văn bản	Tên của người bán.
`expectsAcceptanceOf.seller.sameAs`	URL	URL của một trang web xác định người bán; ví dụ: trang chủ của người bán.

Đối với mỗi Loại tường phí được hỗ trợ, ví dụ bên dưới sẽ cung cấp thông tin chi tiết về cách tạo actionAccessibilityObject:

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Miễn phí (không yêu cầu đăng nhập) và chỉ có 1 giờ dùng thử

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "eligibleDuration": 60
    }
  }
}

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Giao dịch mua hàng một lần có chiết khấu

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": [
      {
        "@type": "Offer",
        "name": "Original Price",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": 7.99
          "priceCurrency": "USD"
          "priceType": "https://schema.org/ListPrice"
        },
        "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
          }
        },
        {
          "@type": "Offer",
          "name": "Sale Price",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "price": 4.99
            "priceCurrency": "USD"
            "priceType": "https://schema.org/SalePrice"
          },
          "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
        }
      }
    ]
  }
}

Mua hàng một lần

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

Gói thuê bao một cấp/nhiều cấp/gói bổ sung

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Gói thuê bao và gói bổ sung theo cấp

Sau đây là cách áp dụng gói thuê bao theo cấp và gói bổ sung:

Trong mô hình thuê bao một cấp, nhà cung cấp dịch vụ chỉ có một cấp thuê bao. Tất cả người đăng ký đều có thể truy cập vào cùng một nội dung, bất kể gói thuê bao của họ là gì.
Trong mô hình thuê bao theo cấp, nhà cung cấp dịch vụ có nhiều cấp thuê bao, chẳng hạn như Vàng, Bạc và Đồng. Người dùng có gói thuê bao cấp cao hơn có thể truy cập vào tất cả nội dung của gói thuê bao cấp thấp hơn. Tuy nhiên, người dùng có gói thuê bao cấp thấp hơn sẽ không thể truy cập vào nội dung cấp cao hơn.
Trong mô hình gói thuê bao bổ sung, nhà cung cấp dịch vụ cho phép người dùng mở rộng các quyền của họ và thêm nội dung vào gói thuê bao cơ bản. Người dùng có thể thêm bao nhiêu nội dung tuỳ thích.

Mẫu tổng thể của một thực thể

Đây là ví dụ về mẫu tổng thể của một thực thể:

Mẫu

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "VideoGame",
       "@id": "http://www.example.com/game007",
       "url": "http://www.example.com/game007",
       "name": "Games Bond 007",
       "exampleOfWork": [
        {  },
        {
           "@type": "VideoGame",
            "@id": "http://www.example.com/game007Stadia",
            "url": "http://www.example.com/game007Stadia",
            "name": "Games Bond 007",
            // Other properties
           "potentialAction": [
              {  },
              {
                  "@type": "PlayGameAction",
                  "target": [
                  {  },
                  {  }
                  ],
                 "actionAccessibilityRequirement": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

Định nghĩa các loại dữ liệu có cấu trúc

Phần này cung cấp thông tin chi tiết về các thuộc tính đánh dấu nội dung cho loại thực thể VideoGame. Bạn phải sử dụng các thuộc tính bắt buộc mà chúng tôi liệt kê trong bài viết này để nội dung của bạn đủ điều kiện xuất hiện trong kết quả tìm kiếm. Bạn cũng nên thêm các thuộc tính được đề xuất để bổ sung thông tin về nội dung của mình. Điều này có thể mang lại trải nghiệm tốt hơn cho người dùng và giúp chúng tôi đối chiếu thực thể với Sơ đồ tri thức của Google.

Bảng quy cách VideoGame (Work)

Thuộc tính	Loại dự kiến	Mô tả
`@context`	Văn bản	Bắt buộc. Luôn đặt thành `["http://schema.org", {"@language": "xx"}]`. Giá trị Where `xx` thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh thực thể gốc cần có `@language` được đặt thành mã ngôn ngữ thích hợp theo định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, thì tên được giả định là bằng tiếng Tây Ban Nha, ngay cả khi ngôn ngữ phụ đề/lồng tiếng là tiếng Anh.
`@type`	Văn bản	Bắt buộc. Luôn đặt thành `VideoGame`.
`@id`	URL	Bắt buộc. Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: `https://example.com/1234abc. @id` phải đáp ứng các yêu cầu sau: Riêng biệt trên toàn cầu trong danh mục của bạn. Tĩnh. Giá trị này phải ổn định và không thay đổi theo thời gian, ngay cả khi thuộc tính `url` của trò chơi thay đổi. URL được coi là một chuỗi nguyên vẹn và không cần phải là một đường liên kết đang hoạt động. Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI). Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn. Vì `url` của một thực thể đáp ứng mọi yêu cầu của giá trị nhận dạng, nên bạn nên sử dụng `url` của thực thể làm `@id`. Để biết thêm thông tin chi tiết, hãy xem phần Giá trị nhận dạng.
`url`	URL	Bắt buộc. URL chuẩn của nội dung mà Google dùng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google. `url` phải đáp ứng các yêu cầu sau: `url` phải là duy nhất trên toàn hệ thống. `url` phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu. Đối với đường liên kết sâu của một lượt phát, hãy xem thuộc tính `urlTemplate` của đối tượng target.
`name`	Văn bản	Tên của trò chơi. Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Để biết thêm thông tin chi tiết, hãy xem ví dụ về Nhiều khu vực và ngôn ngữ. Xin lưu ý rằng mỗi ngôn ngữ chỉ được hỗ trợ một tên (cặp ngôn ngữ-quốc gia).
`description`	Văn bản	Rất nên dùng. Bản tóm tắt về trận đấu. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Để biết thêm thông tin chi tiết, hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
`genre`	Văn bản	Danh sách có thứ tự của tất cả các thể loại có liên quan. Ví dụ: `["Action", "Role playing"]`
`image`	ImageObject (Đối tượng hình ảnh)	Rất nên dùng. Hình ảnh liên quan đến trò chơi. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc cần thêm vào `image`, hãy xem Thuộc tính hình ảnh.
`applicationCategory`	Văn bản	Không bắt buộc. Loại ứng dụng phần mềm. Đặt giá trị thành `Game`.
`exampleOfWork`	VideoGame	Bắt buộc Ấn bản của `VideoGame`. Thực thể `VideoGame` (Bản) này cũng mang thông tin chi tiết về đường liên kết sâu. Để biết thêm thông tin chi tiết, hãy xem bảng thông số kỹ thuật của VideoGame (Phiên bản).
`playMode`	Text (Văn bản) hoặc GamePlayMode (Chế độ chơi)	Không bắt buộc. Cho biết liệu trò chơi này là trò chơi nhiều người chơi, trò chơi phối hợp hay trò chơi một người chơi. Bạn có thể đánh dấu trò chơi là nhiều người chơi, phối hợp và một người chơi cùng lúc. Chấp nhận các giá trị sau: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

Bảng quy cách VideoGame (Phiên bản)

Thuộc tính	Loại dự kiến	Mô tả
`@type`	Văn bản	Bắt buộc. Luôn đặt thành `VideoGame`.
`@id`	URL	Bắt buộc. Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: `https://example.com/1234abc.@id` phải đáp ứng các yêu cầu sau: Riêng biệt trên toàn cầu trong danh mục của bạn. Tĩnh. Giá trị này phải ổn định và không thay đổi theo thời gian, ngay cả khi thuộc tính `url` của trò chơi thay đổi. URL được coi là một chuỗi nguyên vẹn và không cần phải là một đường liên kết đang hoạt động. Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI). Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn. Vì `url` của một thực thể đáp ứng mọi yêu cầu của giá trị nhận dạng, nên bạn nên sử dụng `url` của thực thể làm `@id`. Để biết thêm thông tin chi tiết, hãy xem phần Giá trị nhận dạng.
`url`	URL	Bắt buộc. URL chuẩn của nội dung mà Google dùng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google. `url` phải đáp ứng các yêu cầu sau: `url` phải là duy nhất trên toàn hệ thống. `url` phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu. Đối với đường liên kết sâu của một lượt phát, hãy xem thuộc tính `urlTemplate` của đối tượng target.
`name`	Văn bản	Tên của trò chơi. Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Để biết thêm thông tin chi tiết, hãy xem ví dụ về Nhiều khu vực và ngôn ngữ. Xin lưu ý rằng mỗi ngôn ngữ chỉ được hỗ trợ một tên (cặp ngôn ngữ-quốc gia).
`description`	Văn bản	Rất nên dùng. Bản tóm tắt về trận đấu. Giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Để biết thêm thông tin chi tiết, hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
`genre`	Văn bản	Danh sách có thứ tự của tất cả các thể loại có liên quan. Ví dụ: `["Action", "Role playing"]`
`image`	ImageObject (Đối tượng hình ảnh)	Rất nên dùng. Hình ảnh liên quan đến trò chơi. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc cần thêm vào `image`, hãy xem Thuộc tính hình ảnh.
`applicationCategory`	Văn bản	Không bắt buộc. Loại ứng dụng phần mềm. Đặt giá trị thành `Game`.
`playMode`	Text (Văn bản) hoặc GamePlayMode (Chế độ chơi)	Không bắt buộc. Cho biết liệu trò chơi này là trò chơi nhiều người chơi, trò chơi phối hợp hay trò chơi một người chơi. Bạn có thể đánh dấu trò chơi là nhiều người chơi, phối hợp và một người chơi cùng lúc. Chấp nhận các giá trị sau: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	Bắt buộc nếu áp dụng. Một đối tượng đánh dấu Thao tác cung cấp thông tin chi tiết về thao tác. Sử dụng một mảng để chỉ định các đường liên kết sâu khác nhau ở nhiều khu vực. Để biết thêm thông tin, hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
`gameEdition`	Văn bản	Bắt buộc. Ấn bản của trò chơi này. Ví dụ: trò chơi nổi tiếng "Shadow of the Tomb Raider" có 4 phiên bản: "Croft Edition", "Standard Edition", "Digital Deluxe Edition" và "Ultimate Edition".
`gamePlatform`	Văn bản	Bắt buộc. Nền tảng hoặc hệ thống điện tử được dùng để chơi trò chơi điện tử.
`releasedEvent`	PublicationEvent	Rất nên dùng. `PublicationEvent` được dùng để chỉ định bản phát hành gốc (toàn cầu hoặc địa phương) của nội dung do nhà xuất bản cung cấp.
`releasedEvent.@type`	Văn bản	Bắt buộc. Hãy nhớ luôn đặt thuộc tính này thành `PublicationEvent`.
`releasedEvent.Location`	Quốc gia	Bắt buộc. Các khu vực được liên kết với sự kiện ra mắt này. Sử dụng mã ISO 3166 cho các quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành `EARTH`.
`releasedEvent.startDate`	Ngày hoặc Giờ	Đề xuất. Bắt buộc đối với `ExclusiveEvent`. Ngày bắt đầu xuất bản của thực thể.
`releasedEvent.endDate`	Ngày hoặc Giờ	Không bắt buộc. Đây là ngày hết hạn quyền đối với nội dung.
`releasedEvent.publishedBy`	Organization (Tổ chức) hoặc Person (Người)	Không bắt buộc. Tổ chức hoặc cá nhân đã xuất bản thực thể này.
`contentRating`	Văn bản	Bắt buộc đối với trò chơi dành cho người lớn, nên dùng cho các trò chơi khác. Mức phân loại nội dung tổng thể. Nếu mức phân loại nội dung được cung cấp dưới dạng chuỗi văn bản, thì hai biến thể sẽ được chấp nhận: Cơ quan xếp hạng được thêm vào trước điểm xếp hạng, có khoảng trắng ở giữa. Ví dụ: mức phân loại "Dành cho người lớn" của cơ quan "Uỷ ban phân loại phần mềm giải trí" tại Hoa Kỳ cần được mô tả là `Entertainment Software Rating Board Mature`. Giá trị `RATING NOT KNOWN` (không phân biệt chữ hoa chữ thường) cho biết bạn không biết mức phân loại của trò chơi.
`publisher`	Organization (Tổ chức) hoặc Person (Người)	Không bắt buộc. Tổ chức hoặc cá nhân đã xuất bản thực thể này.
`contributor`	Organization (Tổ chức) hoặc Person (Người)	Không bắt buộc. Một người đóng góp phụ cho thực thể này.

Bảng quy cách hình ảnh

Các Play Game Actions sử dụng lại giản đồ Media Actions để nắm bắt các yêu cầu về hình ảnh. Để biết thêm thông tin, hãy xem quy cách về giản đồ hình ảnh.

Sau đây là một số yêu cầu khác cần lưu ý.

Tỷ lệ khung hình và `contentAttributes`	Độ phân giải tối thiểu (tính bằng pixel)
16:9, áp phích mang tính biểu tượng	3840x2160
2:3, áp phích mang tính biểu tượng	1000x1500
4:3, áp phích mang tính biểu tượng	800x600
1:1, áp phích mang tính biểu tượng	600x600
3:4, áp phích biểu tượng	600x800
16:9, nền tiêu biểu [ưu tiên] hoặc sceneStill	3840x2160
2:3, nền mang tính biểu tượng [ưu tiên] hoặc sceneStill	1000x1500
3:4, nền mang tính biểu tượng [ưu tiên] hoặc sceneStill	600x800

Yêu cầu về định dạng

Đây là những yêu cầu về định dạng mà bạn phải tuân thủ đối với kích thước, chất lượng hình ảnh, v.v.:

Đưa vào những áp phích và sceneStills có độ phân giải cao nhất mà bạn có cho trò chơi.
Hình ảnh phải ở định dạng JPG, PNG hoặc WebP.
URL của hình ảnh phải cho phép thu thập dữ liệu và lập chỉ mục.
Kích thước tệp không được vượt quá 20 MB.
Chúng tôi ưu tiên những hình ảnh phù hợp với cả smallFormat và largeFormat.
Hình ảnh không được chứa những nội dung sau:
- Hình ảnh bị mờ, bị vỡ ảnh, bị xoay hoặc có chất lượng kém.
- Ảnh chụp không có giấy phép hoặc ảnh chụp có sẵn.
- Ảnh khoả thân.
- Nội dung bất hợp pháp.
Bạn có thể thêm các kích thước hình ảnh ngoài những kích thước được liệt kê trong bảng trước đó.

Ví dụ

Các phần sau đây chứa ví dụ về nguồn cấp dữ liệu mẫu cho nhiều trường hợp.

Nguồn cấp dữ liệu mẫu có một thực thể VideoGame

Dưới đây là ví dụ về một thực thể VideoGame đại diện cho trò chơi "Space Wars Made Up Game". Xin lưu ý rằng thực thể này cần được đặt trong phong bì Nguồn cấp dữ liệu trong tệp JSON để Google có thể nhìn thấy.

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type":"DataFeed",
   "dateModified":"2021-07-20T00:44:51Z",
   "dataFeedElement":[
      {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@id":"https://www.examplegame.com/VideoGame007",
         "@type":"VideoGame",
         "url":"https://www.examplegame.com/games/VideoGame007",
         "name":"Space Wars Made Up Game",
         "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
         "genre":[
            "Role playing"
         ],
         "applicationCategory":"Game",
         "publisher":{
            "name":"Made Up Media",
            "@id":"https://www.examplegame.com/uniuqe-id-org",
            "@type":"Organization"
         },
         "contributor":[
            {
               "roleName":"developer",
               "name":"Alpha Labs Man Made Studio",
               "@id":"https://www.studionice.com/uniuqe-id-alpha",
               "@type":"Organization"
            }
         ],
         "playMode":[
           "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP"
         ],
         "image":[
            {
               "@context":"http://schema.org",
               "@type":"ImageObject",
               "name":"keyart_1X1_3X",
               "contentUrl":"https://lh3.googleusercontent.com/ept4",
               "copyrightHolder":{
                  "@type":"Organization",
                  "name":"Studio Nice"
               },
               "additionalProperty":[
                  {
                     "@type":"PropertyValue",
                     "name":"contentAttributes",
                     "value":[
                         "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO"
                     ]
                  }
               ]
            }
         ],
         "exampleOfWork":{
            "@id":"https://www.examplegame.com/VideoGame007/version/v3",
            "name":"Space Wars Made Up Game",
            "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
            "gameEdition":"Early Access",
            "url":"https://www.examplegame.com/VideoGame007/version/v3/stream",
            "contentRating":[
               "Entertainment Software Rating Board Mature",
               "Pan European Game Information 12",
               "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12"
            ],
            "applicationCategory":"Game",
            "releasedEvent":[
               {
                  "@type":"PublicationEvent",
                  "startDate":"2020-11-30",
                  "location":{
                     "@type":"Country",
                     "name":"US"
                  }
               }
            ],
            "potentialAction":{
               "@type":"PlayGameAction",
               "gameAvailabilityType":"DEMO",
               "target":[
                  {
                     "@type":"EntryPoint",
                     "urlTemplate":"https://www.examplegame.com/VideoGame007/play",
                     "actionPlatform":[
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.org/AndroidPlatform",
                        "http://schema.org/AndroidTVPlatform",
                        "http://schema.org/IOSPlatform"
                     ]
                  }
               ],
               "actionAccessibilityRequirement":[
                  {
                     "@type":"ActionAccessSpecification",
                     "availabilityStarts": "2015-01-01T00:00Z",
                     "availabilityEnds": "2015-12-31T00:00Z",
                     "eligibleRegion":{
                        "@type":"Country",
                        "name":[
                           "US"
                        ]
                     },
                     "category":"subscription",
                     "requiresSubscription":{
                        "@type":"MediaSubscription",
                        "name":"",
                        "@id":""
                     }
                  }
               ],
            },
            "gamePlatform": "Google Stadia",
            "publisher":{
               "name":"Made Up Media",
               "@id":"https://www.examplegame.com/uniuqe-id-org",
               "@type":"Organization"
            },
            "contributor":[
               {
                  "roleName":"developer",
                  "name":"Alpha Labs Man Made Studio",
                  "@id":"https://www.studionice.com/uniuqe-id-alpha",
                  "@type":"Organization"
               }
            ]
         }
      }
   ]
}

Biểu thị một hình ảnh mẫu có hai nhân vật trong trò chơi

Hình minh hoạ một người phụ nữ và chú chim trên cánh đồng.

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "VideoGame",
  "@id": "http://www.examplegame.com/videoGame1",
  "url": "http://www.examplegame.com/videoGame1",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mauren and Lord Wingflap!",
    "Keywords": "Mauren, Lord Wingflap the Destroyer",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" }
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Xử lý nhiều khu vực và ngôn ngữ (Quốc tế hoá)

Một thực thể VideoGame có thể được cung cấp ở nhiều khu vực và ngôn ngữ.

Lưu ý: @language biểu thị ngôn ngữ được dùng cho @value; nhãn này không có nghĩa là nội dung có sẵn bằng ngôn ngữ đó hoặc ở khu vực đó. Ví dụ: pt-br trong @language không có nghĩa là nội dung có sẵn bằng tiếng Bồ Đào Nha ở Brazil; mà là xác định ngôn ngữ được dùng trong @value là tiếng Bồ Đào Nha Brazil. Dùng eligibleRegion để chỉ định nơi có nội dung.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "VideoGame",
  "@id": "http://www.example.com/my_favorite_game",
  "url": "http://www.example.com/my_favorite_game",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Game"
    },
    {
      "@language": "es-mx",
      "@value": "mi juego favorito"
    },
    {
      "@language": "ja-jp",
      "@value": "私のfavourite game"
    }
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    },
    {
      "@language": "ja-jp",
      "@value": "PaulとJennyが会う。"
    }
  ],
  "potentialAction": [
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-06-24T11:00:00Z",
        "availabilityEnds": "2041-06-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 19.99,
            "priceCurrency": "USD",
            "priceType": "https://schema.org/ListPrice"
          },
          {
            "@type": "UnitPriceSpecification",
            "price": 360.00,
            "priceCurrency": "MXN",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    },
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-07-24T11:00:00Z",
        "availabilityEnds": "2041-07-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "JP"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "ja"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 2189,
            "priceCurrency": "JPY",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    }
  ],
  // Other properties...
}

Thao tác trong Play Games

Tổng quan

Giới thiệu về Thao tác trên Play Games

Bắt đầu

Trước khi bắt đầu

Hiểu cách sử dụng các khái niệm Tác phẩm và Ấn phẩm trong tài liệu này

URL chuẩn (url)

Giá trị nhận dạng (@id)

Hiểu và xác định các yêu cầu về đường liên kết sâu

Các loại tường phí

Tạo nguồn cấp dữ liệu

Tuân thủ yêu cầu về kích thước, số lượng và định dạng của tệp nguồn cấp dữ liệu

Tuân thủ các yêu cầu về nội dung nguồn cấp dữ liệu

Lưu trữ nguồn cấp dữ liệu

Gửi nguồn cấp dữ liệu để xem xét

Mẫu

Cách hoạt động của quy trình xác thực nguồn cấp dữ liệu

Tiêu chí chấp nhận nguồn cấp dữ liệu

Cập nhật nguồn cấp dữ liệu nếu cần

Tài liệu tham khảo

Tổng quan về cấu trúc nguồn cấp dữ liệu

Phong bì nguồn cấp dữ liệu

Mẫu

Đối tượng đánh dấu nội dung

Đối tượng đánh dấu hành động

Mẫu

Mục tiêu

Ví dụ:

Quy cách về quyền truy cập vào hành động

Ví dụ về Mục tiêu có 2 đường liên kết sâu

Quy cách về quyền truy cập vào hành động

Quy cách về gói thuê bao nội dung nghe nhìn

Thuộc tính của ưu đãi

Miễn phí (không yêu cầu đăng nhập)

Miễn phí (không yêu cầu đăng nhập) và chỉ có 1 giờ dùng thử

Miễn phí (cần đăng nhập)

Giao dịch mua hàng một lần có chiết khấu

Mua hàng một lần

Gói thuê bao một cấp/nhiều cấp/gói bổ sung

Gói thuê bao và gói bổ sung theo cấp

Mẫu tổng thể của một thực thể

Mẫu

Định nghĩa các loại dữ liệu có cấu trúc

Bảng quy cách VideoGame (Work)

Bảng quy cách VideoGame (Phiên bản)

Bảng quy cách hình ảnh

Yêu cầu về định dạng

Ví dụ

Nguồn cấp dữ liệu mẫu có một thực thể VideoGame

Biểu thị một hình ảnh mẫu có hai nhân vật trong trò chơi

Xử lý nhiều khu vực và ngôn ngữ (Quốc tế hoá)