Hành động xem thuộc tính chung

Phần này cung cấp thông tin chi tiết về các thuộc tính chung của Thao tác trên đồng hồ.

Thuộc tính của mã đánh dấu hành động

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 WatchAction.
target EntryPoint Bắt buộc – Một đối tượng đích cung cấp mối liên kết của đườ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 nội dung.
target.inLanguage Văn bản Không bắt buộc – Ngôn ngữ gốc của bộ phim/chương trình ở đị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. Thao tác đối với nội dung nghe nhìn hỗ trợ những nội dung sau:
  • 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 di động.
  • http://schema.org/AndroidPlatform: Nền tảng Tìm kiếm và PlayGuide 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.
  • http://schema.googleapis.com/GoogleVideoCast: Nền tảng Truyền và Nền tảng Home trên thiết bị Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Nền tảng Truyền và Nền tảng Home trên thiết bị Chromecast (chỉ có Thao tác nghe).
Xem phần Các loại nền tảng để biết các yêu cầu.
target.additionalProperty PropertyValue Bắt buộc nếu có – Danh sách các cặp giá trị thuộc tính để biểu thị các thuộc tính bổ sung của đường liên kết sâu. Điều này có thể bao gồm những nội dung sau:
  • contentLanguage: Ngôn ngữ phát sóng (lồng tiếng), ở định dạng BCP 47. Bạn bắt buộc phải dùng thuộc tính này nếu nội dung được lồng tiếng bằng một ngôn ngữ khác. Sử dụng một mảng cho nhiều mã ngôn ngữ.
  • subtitleLanguage: Ngôn ngữ của phụ đề, ở định dạng BCP 47. Sử dụng một mảng cho nhiều mã ngôn ngữ.
  • cameraAngle: Góc quay của nội dung; ví dụ: "Góc ngang tầm mắt" và "Góc cao". Nếu nội dung có ở nhiều góc camera, thì bạn phải dùng thuộc tính này. Sử dụng một mảng cho nhiều góc camera.
  • videoFormat: Định dạng tệp dùng để lưu trữ dữ liệu video kỹ thuật số; ví dụ: "SD" cho độ phân giải chuẩn và "HD" cho độ phân giải cao. Các định dạng video hợp lệ bao gồm SD, HD, 2K, 4K và 8K. Sử dụng một mảng cho nhiều định dạng video.
  • audioDescriptionLanguage: Một mảng các ngôn ngữ âm thanh được hỗ trợ, ở định dạng BCP 47 hỗ trợ tính năng Mô tả bằng âm thanh. Đây là một tập hợp con của mảng contentLanguage.
Xem ví dụ về additionalProperty.
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 của nội dung. Xem Thuộc tính chỉ định quyền truy cập vào thao tác.

Hãy xem các trang sau để biết các chủ đề liên quan đến những thuộc tính này:

Thuộc tính chỉ định 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 thêm thông tin, 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 category 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 TVSeries có một số nội dung TVEpisode được đặt thành nologinrequired và một số nội dung được đặt thành subscription, hãy đặt TVSeries này thành nologinrequired.

actionAccessibilityRequirement.availabilityStarts Ngày

Bắt buộc – Ngày mà sau đó hành động 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.

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. Việc này sẽ giúp tăng cơ hội nội dung xuất hiện trên các nền tảng của Google đúng giờ.

actionAccessibilityRequirement.availabilityEnds Ngày Bắt buộc – Ngày mà sau đó hành động sẽ không còn được cung cấp nữa, ở định dạng ISO 8601 (bao gồm cả múi giờ).
  • 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 được 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. Việc này sẽ làm tăng khả năng nội dung 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 (Quốc gia), City (Thành phố), State (Tiểu bang), GeoShape (Hình dạng địa lý) hoặc Text (Văn bản) Bắt buộc – Khu vực nơi nội dung được cung cấp. Sử dụng chuỗi đặc biệt EARTH nếu nội dung có trên toàn cầu.
actionAccessibilityRequirement.ineligibleRegion Country (Quốc gia), City (Thành phố), State (Tiểu bang) hoặc GeoShape (Hình dạng địa lý) Bắt buộc nếu có – Các khu vực mà 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.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Bắt buộc nếu có – Thông tin chi tiết về gói thuê bao mà người dùng cần để truy cập vào nội dung. Xem Các thuộc tính của gói thuê bao nội dung nghe nhìn.

  • Cung cấp thuộc tính này nếu categorysubscription hoặc externalSubscription.
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 hoặc externalsubscription)
Nếu giá là 0,00, hãy xoá hoàn toàn đối tượng Offer và đặt category từ đối tượng ActionAccessSpecification thành free. Xem Thuộc tính của ưu đãi.
actionAccessibilityRequirement.additionalProperty PropertyValue Bắt buộc nếu áp dụng – Thông tin tham chiếu đến gói thuê bao sẽ xuất hiện trong trải nghiệm.
actionAccessibilityRequirement.additionalProperty.name Văn bản Bắt buộc – Luôn đặt thành "DisplaySubscriptionIdentifier"
actionAccessibilityRequirement.additionalProperty.value Văn bản Bắt buộcrequiresSubscription.@id sẽ xuất hiện cho thực thể.

Thuộc tính gói thuê bao nội dung nghe nhìn

Bắt buộc nếu actionAccessibilityRequirement.categorysubscription hoặc externalSubscription.

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 thông qua 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 thông qua 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 lại dùng tên PKG1a, hãy dùng PKG1.
  • Đối với Nhà cung cấp TVE, đây là tên trình xác thực đã đăng ký với trình xác thực TVE của bạn. Đây là một chuỗi nhận dạng duy nhất tên dịch vụ của bạn bằng Trình xác thực TVE.
  • Nếu gói thuê bao có nhiều tên, vui lòng chỉ định dưới dạng một mảng giá trị. Hãy xem ví dụ sau đây về cách thêm một mảng tên có nhiều bản dịch
requiresSubscription.sameAs URL Trang mô tả gói thuê bao.
requiresSubscription.identifier Văn bản Bắt buộc nếu categorysubscriptioncommonTierfalse – Một chuỗi duy nhất cho gói thuê bao này, thể hiện 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 giá trị nhận dạng:
    tên miền + dấu hai chấm (:) + cấp độ truy cập vào nội dung, Ví dụ : example.com:basic, example.com:premium, example.com:sports
  • Thuộc tính này sẽ giống với giá trị nhận dạng quyền nếu bạn đang cung cấp một API quyền
requiresSubscription.authenticator Tổ chức Bắt buộc nếu categoryexternalsubscription – Một vùng chứa cung cấp thông tin chi tiết về trình xác thực của nhà cung cấp bên ngoài.
requiresSubscription.authenticator.@type Văn bản Bắt buộc nếu categoryexternalsubscription – Luôn đặt thành Organization.
requiresSubscription.authenticator.name Văn bản Bắt buộc nếu categoryexternalsubscription – Tên của dịch vụ xác thực. Đối với nhà cung cấp TVE, hãy đặt thành TVE
requiresSubscription.commonTier Boolean Bắt buộc nếu áp dụng – Bạn phải cung cấp thuộc tính này 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.

Yêu cầu đối với Entitlement API

Bạn phải dùng API quyền nếu actionAccessibilityRequirement.categorysubscription hoặc externalSubscription 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. Đừng thêm thông tin này nếu gói thuê bao của bạn có một cấp và cho phép truy cập vào tất cả nội dung trong danh mục của bạn.

  • Công ty A có một gói thuê bao duy nhất cho phép người dùng đã đăng ký truy cập vào tất cả nội dung hiện có: Không bắt buộc phải có Giá trị nhận dạng quyền / API
  • Công ty B có một gói thuê bao cơ bản cho phép truy cập vào một số nội dung và một gói thuê bao cao cấp cho phép truy cập vào nội dung cao cấp: Giá trị nhận dạng quyền / API là bắt buộc
  • Công ty C có một gói thuê bao cơ bản cho phép truy cập vào một số nội dung và các gói bổ sung cho phép truy cập vào nội dung của bên thứ ba: Giá trị nhận dạng quyền / API là bắt buộc

Hãy xem các trang sau để biết các chủ đề liên quan đến những thuộc tính này:

Thuộc tính của ư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.price Number Bắt buộc – Giá mua nội dung. Giá phải là một giá trị dương khác 0. Đối với những thực thể có giá là 0,00, vui lòng chỉ định danh mục là "miễn phí".
expectsAcceptanceOf.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.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 Văn bản URL của một trang web xác định người bán; ví dụ: trang chủ của người bán.

Hãy xem các trang sau để biết các chủ đề liên quan đến những thuộc tính này:

Giá trị nhận dạng

Nguồn cấp dữ liệu Thao tác với nội dung nghe nhìn chấp nhận nhiều giá trị nhận dạng có thể giúp xác định một thực thể theo cách rõ ràng. Các giá trị nhận dạng này có thể giúp đẩy nhanh quá trình điều chỉnh nội dung trong nguồn cấp dữ liệu của bạn sao cho khớp với nội dung trong cơ sở dữ liệu của Google. Mặc dù hầu hết các giá trị nhận dạng này có thể được thêm vào nguồn cấp dữ liệu bằng cách sử dụng thuộc tính identifier trên nhiều loại thực thể, nhưng EIDR có thuộc tính đại diện riêng. Cả hai điều này đều được thảo luận bên dưới.

Thuộc tính giá trị nhận dạng

Thuộc tính Loại dự kiến Mô tả
identifier Văn bản Rất nên dùng – Giá trị nhận dạng (thường là giá trị nhận dạng bên ngoài) xác định rõ ràng một thực thể nhất định. Bạn có thể sử dụng nhiều giá trị nhận dạng.

Thuộc tính này có sẵn trên tất cả các loại thực thể Watch Action.

Bảng bên dưới liệt kê các giá trị nhận dạng và thuộc tính phụ được chấp nhận của thuộc tính identifier. Xem Ví dụ về mã nhận dạng/EIDR trong phần Ví dụ về nguồn cấp dữ liệu Watch Actions.
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 PropertyValue.
propertyID Văn bản Bắt buộc – Chúng tôi hỗ trợ các loại giấy tờ tuỳ thân sau:
  • TMS_ROOT_ID: Mã nhận dạng gốc của Gracenote (TMS) (ví dụ: 15829).
  • . Điều này không áp dụng cho các thực thể Tổ chức và BroadcastService, trong đó chỉ nên sử dụng TMS_ID.
  • TMS_ID: Mã biến thể Gracenote (TMS) (ví dụ: MV000398520000).
  • WIKIDATA_ID: Mã nhận dạng WikiData (ví dụ: Q134773).
  • IMDB_ID: Mã nhận dạng IMDB (ví dụ: tt0109830).
  • OPTA_ID: Mã nhận dạng OPTA Sports.
  • STATS_ID: Mã nhận dạng STATS Perform.
  • VIP_TIMES_ID: Mã nhận dạng VIPTimes (Nihon Tarento Meikan) của Nhật Bản dành cho những người nổi tiếng ở Nhật Bản.
  • DMA_ID: Mã vùng tiếp thị được chỉ định của Hoa Kỳ, được dùng trong đối tượng GeoShape.
  • _PARTNER_ID_: Thuộc tính này phải chứa chuỗi "_PARTNER_ID_", giá trị phải là một mã nhận dạng duy nhất mà nhà cung cấp dịch vụ sử dụng (nội bộ hoặc bên ngoài) để xác định thực thể (ví dụ: 12345 hoặc a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Văn bản Bắt buộc – Giá trị cho hệ thống mã nhận dạng được chỉ định.

Thuộc tính EIDR

EIDR (viết tắt của The Entertainment Identifier Registry – Sổ đăng ký giá trị nhận dạng nội dung giải trí) là một hệ thống giá trị nhận dạng riêng biệt trên toàn cầu cho nhiều nội dung nghe nhìn, bao gồm cả phim điện ảnh và chương trình truyền hình. Hệ thống nhận dạng sẽ phân giải một giá trị nhận dạng thành một bản ghi siêu dữ liệu được liên kết với các tiêu đề, bản chỉnh sửa cấp cao nhất, v.v. Bảng sau đây liệt kê các thuộc tính liên kết với EIDR và cách sử dụng các thuộc tính đó.

Thuộc tính Loại dự kiến Mô tả
titleEIDR Văn bản Rất nên dùng – Mã nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung/trừu tượng nhất.

Thuộc tính này có trên các trang quy cách thực thể TVSeries, TVSeason, TVEpisodeMovie.

Ví dụ: titleEIDR cho bộ phim có tên "Ghostbusters" là "10.5240/7EC7-228A-510A-053E-CBB8-J".

Hãy xem Ví dụ về mã nhận dạng/EIDR trong phần Ví dụ về nguồn cấp dữ liệu Watch Actions.
editEIDR Văn bản Rất nên dùng – Mã nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một bản chỉnh sửa/ấn bản cụ thể của một tác phẩm điện ảnh hoặc truyền hình.

Thuộc tính này có trên các trang chỉ định thực thể TVEpisodeMovie.

Ví dụ: bộ phim có tên "Ghostbusters" có titleEIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số bản chỉnh sửa, chẳng hạn như "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

Thuộc tính titleEIDRbắt buộc khi bạn cung cấp editEIDR.

Xem Ví dụ về mã nhận dạng/EIDR trong phần Ví dụ về nguồn cấp dữ liệu của Thao tác xem.

Cơ quan phân loại nội dung

Hãy sử dụng các giá trị trong bảng này cho BroadcastService.contentRating, Movie.contentRatingTVSeries.contentRating. Cơ quan xếp hạng phải được thêm vào trước giá trị xếp hạng. Ví dụ:

  • Một bộ phim được phân loại là "R" ở Hoa Kỳ phải có giá trị Movie.contentRating là "MPAA R".
  • Một bộ phim truyền hình được phân loại là "TV-MA" ở Hoa Kỳ phải có giá trị TVSeries.contentRating là "TV_PG TV-MA".

Quốc gia Cơ quan phân loại chương trình truyền hình Cơ quan phân loại phim
Albania (AL) Không có Không có
Angola (AO) Không có CCE
Antigua và Barbuda (AG) Không có MPAA
Argentina (AR) INCAA INCAA
Armenia (AM) Không có MKRF/NGA
Aruba (AW) Không có Không có
Úc (AU) ACB TV ACB Movies
Áo (AT) FSK FSK
Azerbaijan (AZ) Không có MKRF/NGA
Bahrain (BH) Không có MPAA
Belarus (BY) Không có MKRF/NGA
Bỉ (BE) Không có MPAA
Belize (BZ) Không có Không có
Benin (BJ) Không có CNC
Bolivia (BO) Không có MPAA
Bosnia và Herzegovina (BA) Không có MPAA
Botswana (BW) Không có MPAA
Brazil (BR) CLASSIND CLASSIND
Burkina Faso (BF) Không có CNC
Campuchia (KH) Không có Không có
Canada (CA) CA_TV CHVRS
Cape Verde (CV) Không có CCE
Chile (CL) Không có MPAA
Colombia (CO) Không có MPAA
Costa Rica (CR) Không có MPAA
Croatia (HR) Không có Không có
Síp (CY) Không có GRFILM
Cộng hoà Séc (CZ) Không có CZFILM
Đan Mạch (DK) Không có MCCYP
Ecuador (EC) Không có MPAA
Ai Cập (EG) Không có MPAA
El Salvador (SV) Không có MPAA
Estonia (EE) Không có EEFILM
Fiji (FJ) Không có Không có
Phần Lan (FI) Không có MEKU
Pháp (FR) CSA CSA
Gabon (GA) Không có CNC
Đức (DE) FSK FSK
Hy Lạp (GR) ESR GRFILM
Guatemala (GT) Không có MPAA
Haiti (HT) Không có Không có
Honduras (HN) Không có MPAA
Hồng Kông (HK) CA FCO
Hungary (HU) Không có MPAA
Iceland (IS) Không có KIJKWIJZER
Ấn Độ (IN) CBFC CBFC
Indonesia (ID) KPI LSF
Ireland (IE) Không có IFCO
Ý (IT) AGCOM AGCOM
Bờ Biển Ngà (CI) Không có CNC
Jamaica (JM) Không có MPAA
Nhật Bản (JP) NA EIRIN
Jordan (JO) Không có MPAA
Kazakhstan (KZ) Không có MRKF
Hàn Quốc (KR) KMRB KMRB
Kuwait (KW) Không có MPAA
Kyrgyzstan (KG) Không có MKRF/NGA
Lào (LA) Không có Không có
Latvia (LV) Không có NKCLV
Liban (LB) Không có MPAA
Lithuania (LT) Không có Không có
Luxembourg (LU) Không có KIJKWIJZER
Macedonia (MK) Không có MPAA
Malaysia (MY) Không có FCBM
Mali (ML) Không có CNC
Malta (MT) Không có MCCAA
Mauritius (MU) Không có BBFC
Mexico (MX) RTC RTC
Moldova (MD) Không có Không có
Namibia (NA) Không có Không có
Nepal (NP) Không có MPAA
Hà Lan (NL) KIJKWIJZER KIJKWIJZER
New Zealand (NZ) BSA OFLC
Nicaragua (NI) Không có MPAA
Niger (NE) Không có CNC
Na Uy (NO) Không có MEDIETILSYNET
Oman (OM) Không có MPAA
Panama (PA) Không có MPAA
Papua New Guinea (PG) Không có MPAA
Paraguay (PY) Không có MPAA
Peru (PE) Không có MPAA
Philippines (PH) MTRCB MTRCB
Ba Lan (PL) Không có MPAA
Bồ Đào Nha (PT) Không có CCE
Qatar (QA) Không có MPAA
Nga (RU) MKRF/NGA MKRF/NGA
Rwanda (RW) Không có CNC
Ả Rập Xê Út (SA) Không có MPAA
Senegal (SN) Không có MPAA
Singapore (SG) Không có MDA
Slovakia (SK) Không có MPAA
Slovenia (SI) Không có MPAA
Nam Phi (ZA) FPB FPB
Tây Ban Nha (ES) SETSI ICAA
Sri Lanka (LK) Không có Không có
Thuỵ Điển (SE) Không có SMSA
Thuỵ Sĩ (CH) FSK FSK
Đài Loan (TW) Không có MOCTW
Tajikistan (TJ) Không có MKRF/NGA
Tanzania (TZ) Không có MPAA
Thái Lan (TH) Không có BFVC
Togo (TG) Không có CNC
Trinidad và Tobago (TT) Không có Không có
Thổ Nhĩ Kỳ (TR) RTÜK ECBMCT
Turkmenistan (TM) Không có MKRF/NGA
Uganda (UG) Không có MPAA
Ukraina (UA) Không có Không có
Các Tiểu vương quốc Ả Rập Thống nhất (AE) Không có MPAA
Vương Quốc Anh (GB) BBFC BBFC
Hoa Kỳ (US) TV_PG MPAA
Uruguay (UY) Không có MPAA
Uzbekistan (UZ) Không có MKRF/NGA
Venezuela (VE) Không có RESORTEVIOLENCIA
Việt Nam (VN) Không có MCST
Zambia (ZM) Không có MPAA
Zimbabwe (ZW) Không có MPAA

Thuộc tính GeoShape

Đối tượng GeoShape chứa một trong các kiểu dữ liệu sau:

Thuộc tính Loại dự kiến Mô tả
@id URL Bắt buộc – Giá trị nhận dạng của khu vực địa lý ở định dạng URI.
@type Văn bản Bắt buộc – Luôn đặt thành GeoShape.
addressCountry Văn bản Bắt buộcMã quốc gia gồm 2 chữ cái theo ISO 3166-1 alpha-2.
postalCode Văn bản Không bắt buộc – Danh sách gồm một hoặc nhiều mã bưu chính và/hoặc mã FSA (khu vực phân loại chuyển tiếp).
identifier PropertyValue Không bắt buộcMã Mảng thị trường được chỉ định (DMA), là mã nhận dạng của một khu vực ở Hoa Kỳ nơi mọi người nhận được cùng một kênh và chương trình truyền hình.
identifier.@type Văn bản Bắt buộc – Luôn đặt thành PropertyValue.
identifier.propertyID Văn bản Bắt buộc – Luôn đặt thành DMA_ID.
identifier.value Văn bản Bắt buộc – Mã DMA của khu vực.

Ví dụ về đối tượng GeoShape chứa danh sách mã bưu chính:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Ví dụ về đối tượng GeoShape chứa tổ hợp FSA (khu vực phân loại chuyển tiếp) và mã bưu chính:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Ví dụ về đối tượng GeoShape chứa mã DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}