REST Resource: adUnits

Tài nguyên: Đơn vị quảng cáo

Một đơn vị quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "impressionDataRanges": [
    {
      object (ImpressionDataRange)
    }
  ],
  "photoUrls": [
    string
  ],
  "products": [
    string
  ]
}
Trường
name

string

Tên tài nguyên của đơn vị quảng cáo ở định dạng: adUnits/{id}. Ví dụ: adUnits/adUnit123.
externalId

string

Không bắt buộc. Mã nhận dạng do người bán quản lý có lẽ nằm trong hệ thống của riêng họ. Sau khi đặt, sẽ không thể thay đổi. Bạn không nên sử dụng thuộc tính này trong nội bộ và các quy tắc ràng buộc sẽ không được thực thi.
displayName

string

Bắt buộc. Tên hiển thị của đơn vị quảng cáo.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.
description

string

Không bắt buộc. Trường dạng tự do bổ sung để mô tả đơn vị quảng cáo.
labels

map (key: string, value: string)

Không bắt buộc. Bộ nhãn dạng tự do để mô tả đơn vị quảng cáo này.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
attributes[]

enum (AdUnitAttribute)

Không bắt buộc. Các thuộc tính để xác định thêm đơn vị quảng cáo này.
creatives[]

object (CreativeSpecification)

Không bắt buộc. Danh sách các mẫu quảng cáo được phép có thể được phân phát cho đơn vị quảng cáo này. Bạn cũng có thể xác định giá trị này ở cấp Sản phẩm.
createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tạo cho đơn vị quảng cáo.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian được cập nhật gần đây nhất cho đơn vị quảng cáo.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
state

enum (AdUnitState)

Chỉ có đầu ra. Trạng thái của đơn vị quảng cáo. Nếu AD_UNIT_STATE_ Vui lòng cho biết lý do bị từ chối sẽ chứa lý do.
rejectedReason

string

Chỉ có đầu ra. Nếu approve_status là AD_UNIT_APPROVAL_STATUS_ bởi, trường này sẽ chứa lý do.
location

object (LatLng)

Bắt buộc. Bất biến. Vĩ độ và kinh độ của đơn vị quảng cáo ở định dạng độ đã ký.
directionSet

boolean

Bắt buộc. Đúng nếu bạn đã đặt hướng.
direction

integer

Không bắt buộc. Bất biến. Hướng chính tính theo độ, hướng bắc biểu thị số 0. [0 – 360).
elevationMetersSet

boolean

Bắt buộc. Đúng nếu bạn đặt CAOMeters.
elevationMeters

number

Không bắt buộc. Bất biến. Khoảng cách từ cuối đơn vị quảng cáo đến mặt đất tính bằng mét.
physicalWidthMetersSet

boolean

Bắt buộc. "True" nếu physicalWidthMeters được đặt.
physicalWidthMeters

number

Không bắt buộc. Bất biến. Chiều rộng vật lý của đơn vị quảng cáo tính bằng mét.
physicalHeightMetersSet

boolean

Bắt buộc. "True" nếu physicalHeightMeters được đặt.
physicalHeightMeters

number

Không bắt buộc. Bất biến. Chiều cao thực tế của đơn vị quảng cáo tính bằng mét.
venue

enum (OutOfHomeVenue)

Không bắt buộc. Loại địa điểm vắng nhà theo tiêu chuẩn của Đạo luật bảo vệ dữ liệu liên bang (DPAA). Đây là trường thông tin có thể hiển thị cho các nhà quảng cáo và cũng có thể được sử dụng để lọc đơn vị quảng cáo.
fixedLocation

boolean

Không bắt buộc. Quảng cáo ở vị trí cố định (biển quảng cáo) hay đang di chuyển (taxi).
indoors

boolean

Bắt buộc. Liệu đơn vị quảng cáo có ở trong nhà hay không.
impressionDataRanges[]

object (ImpressionDataRange)

Bắt buộc. Phạm vi dữ liệu lượt hiển thị được liên kết với đơn vị quảng cáo này. Phạm vi ngày dự kiến sẽ không trùng lặp. Dữ liệu lượt hiển thị là bắt buộc để đơn vị quảng cáo đủ điều kiện để mua.
photoUrls[]

string

Không bắt buộc. URL ảnh của đơn vị quảng cáo.
products[]

string

Bắt buộc. Tên tài nguyên của các sản phẩm được liên kết với đơn vị quảng cáo này theo định dạng: products/{id}. Ví dụ: products/product123.

AdUnitAttribute

Các thuộc tính có thể dùng để xác định thêm đơn vị quảng cáo.

Enum
AD_UNIT_ATTRIBUTE_UNSPECIFIED Giá trị mặc định khi Thuộc tính đơn vị quảng cáo không được chỉ định hoặc không xác định trong phiên bản này.
AD_UNIT_ATTRIBUTE_ILLUMINATED Đơn vị quảng cáo có hiển thị trong bóng tối nếu ở thế giới thực.
AD_UNIT_ATTRIBUTE_DIGITAL Nếu không bao gồm đơn vị quảng cáo thực cổ điển thì đơn vị quảng cáo kỹ thuật số ngụ ý.
AD_UNIT_ATTRIBUTE_PHYSICAL Đơn vị quảng cáo tồn tại dưới dạng một đối tượng trong thế giới thực.

AdUnitState

Trạng thái của đơn vị quảng cáo từ góc độ của người bán.

Enum
AD_UNIT_STATE_UNSPECIFIED Giá trị mặc định khi Trạng thái đơn vị quảng cáo không được chỉ định hoặc không xác định trong phiên bản này.
AD_UNIT_STATE_PENDING Đơn vị quảng cáo đang chờ phê duyệt.
AD_UNIT_STATE_APPROVED Đơn vị quảng cáo đã được phê duyệt.
AD_UNIT_STATE_REJECTED Đơn vị quảng cáo bị từ chối.
AD_UNIT_STATE_DELETED Đơn vị quảng cáo đã bị xoá.

OutOfHomeVenue

Danh sách các loại địa điểm tổ chức ngoài trời theo Tiêu chuẩn DPAA.

Enum
OOH_VENUE_UNSPECIFIED Giá trị mặc định khi địa điểm OOH không được chỉ định hoặc không xác định trong phiên bản này.
OOH_VENUE_AIRBORNE Địa điểm tổ chức ngoài trời được phân loại là đường hàng không.
OOH_VENUE_AIRPORTS_GENERAL Địa điểm tổ chức sự kiện ra khỏi nhà được phân loại là sân bay chung.
OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM Địa điểm ở bên ngoài nhà được phân loại là nơi nhận hành lý tại sân bay.
OOH_VENUE_AIRPORTS_TERMINAL Địa điểm tổ chức sự kiện ra khỏi nhà được phân loại là nhà ga tại sân bay.
OOH_VENUE_AIRPORTS_LOUNGES Địa điểm tổ chức ngoài trời được phân loại là phòng thư giãn tại sân bay.
OOH_VENUE_ATMS Địa điểm tổ chức hoạt động bên ngoài nhà được phân loại là máy ATM.
OOH_VENUE_BACKLIGHTS Địa điểm bên ngoài nhà được phân loại là đèn nền.
OOH_VENUE_BARS Địa điểm giải trí bên ngoài nhà được phân loại là quán bar.
OOH_VENUE_BENCHES Địa điểm tổ chức ngoài trời được phân loại là ghế băng.
OOH_VENUE_BIKE_RACKS Địa điểm tổ chức sự kiện bên ngoài nhà được phân loại là giá dựng xe đạp.
OOH_VENUE_BULLETINS Địa điểm tổ chức bên ngoài nhà được phân loại là bản tin.
OOH_VENUE_BUSES Địa điểm tổ chức giải đấu ngoài trời được phân loại là xe buýt.
OOH_VENUE_CAFES Địa điểm tổ chức giải trí ngoài trời được phân loại là quán cà phê.
OOH_VENUE_CASUAL_DINING_RESTAURANTS Địa điểm tổ chức giải trí ngoài trời được phân loại là nhà hàng bình dân.
OOH_VENUE_CHILD_CARE Địa điểm ngoài trời được phân loại là chăm sóc trẻ em.
OOH_VENUE_CINEMA Địa điểm tổ chức giải đấu ngoài trời được phân loại là rạp chiếu phim.
OOH_VENUE_CITY_INFORMATION_PANELS Địa điểm tổ chức giải đấu bên ngoài nhà được phân loại là bảng thông tin thành phố.
OOH_VENUE_CONVENIENCE_STORES Địa điểm tổ chức giải trí ngoài trời được phân loại là cửa hàng tiện lợi.
OOH_VENUE_DEDICATED_WILD_POSTING Địa điểm tổ chức ngoài trời được phân loại là mục đăng nội dung tự nhiên chuyên biệt.
OOH_VENUE_DOCTORS_OFFICES_GENERAL Địa điểm tổ chức hoạt động bên ngoài nhà được phân loại là phòng khám bác sĩ chung.
OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS Địa điểm ngoài trời được phân loại là phòng khám của bác sĩ sản khoa.
OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS Địa điểm ngoài trời được phân loại là văn phòng bác sĩ nhi khoa.
OOH_VENUE_FAMILY_ENTERTAINMENT Địa điểm tổ chức hoạt động ngoài trời được phân loại là địa điểm giải trí dành cho gia đình.
OOH_VENUE_FERRIES Địa điểm tổ chức giải trí ngoài trời được phân loại là phà.
OOH_VENUE_FINANCIAL_SERVICES Địa điểm tổ chức hoạt động bên ngoài nhà được phân loại là dịch vụ tài chính.
OOH_VENUE_GAS_STATIONS Địa điểm diễn ra bên ngoài nhà được phân loại là trạm xăng.
OOH_VENUE_GOLF_COURSES Địa điểm tổ chức ngoài trời được phân loại là sân gôn.
OOH_VENUE_GYMS Địa điểm ngoài trời được phân loại là phòng tập thể dục.
OOH_VENUE_HOSPITALS Địa điểm tổ chức hoạt động ngoài trời được phân loại là bệnh viện.
OOH_VENUE_HOTELS Địa điểm tổ chức hoạt động ngoài trời được phân loại là khách sạn.
OOH_VENUE_JUNIOR_POSTERS Địa điểm tổ chức sự kiện ngoài trời được phân loại là áp phích dành cho khán giả trẻ.
OOH_VENUE_KIOSKS Địa điểm bên ngoài nhà được phân loại là kiosk.
OOH_VENUE_MALLS_GENERAL Địa điểm tổ chức giải trí bên ngoài nhà được phân loại là trung tâm mua sắm chung.
OOH_VENUE_MALLS_FOOD_COURTS Địa điểm tổ chức hoạt động ngoài trời được phân loại là khu ẩm thực trong trung tâm mua sắm.
OOH_VENUE_MARINE Địa điểm tổ chức giải đấu ngoài trời được phân loại là địa điểm trên biển.
OOH_VENUE_MOBILE_BILLBOARDS Địa điểm ngoài trời được phân loại là biển quảng cáo trên thiết bị di động.
OOH_VENUE_MOVIE_THEATER_LOBBIES Địa điểm tổ chức giải trí bên ngoài nhà, được phân loại là hành lang rạp chiếu phim.
OOH_VENUE_NEWSSTANDS Địa điểm tổ chức ngoài trời được phân loại là các quầy báo.
OOH_VENUE_OFFICE_BUILDINGS Địa điểm tổ chức hoạt động bên ngoài nhà được phân loại là toà nhà văn phòng.
OOH_VENUE_PHONE_KIOSKS Địa điểm bên ngoài nhà được phân loại là kiosk điện thoại.
OOH_VENUE_POSTERS Địa điểm tổ chức sự kiện bên ngoài nhà được phân loại là áp phích.
OOH_VENUE_QSR Địa điểm tổ chức ngoài trời được phân loại là qsr.
OOH_VENUE_RAIL Địa điểm tổ chức giải đấu ngoài trời được phân loại là đường sắt.
OOH_VENUE_RECEPTACLES Địa điểm bên ngoài nhà được phân loại là chỗ đỗ xe.
OOH_VENUE_RESORTS Địa điểm tổ chức giải trí ngoài trời được phân loại là khu nghỉ dưỡng.
OOH_VENUE_RETAIL Địa điểm tổ chức giải trí ngoài trời được phân loại là địa điểm bán lẻ.
OOH_VENUE_SALONS Địa điểm tổ chức ngoài trời được phân loại là thẩm mỹ viện.
OOH_VENUE_SHELTERS Địa điểm ngoài trời được phân loại là nơi trú ẩn.
OOH_VENUE_SPORTS_ARENAS Địa điểm tổ chức giải đấu ngoài trời được phân loại là nhà thi đấu thể thao.
OOH_VENUE_SUBWAY Địa điểm tổ chức giải đấu ngoài trời được phân loại là tàu điện ngầm.
OOH_VENUE_TAXIS Địa điểm tổ chức hoạt động ngoài trời được phân loại là taxi.
OOH_VENUE_TRUCKSIDE Địa điểm tổ chức sự kiện bên ngoài nhà được phân loại là khu vực dành cho xe tải.
OOH_VENUE_UNIVERSITIES Địa điểm tổ chức sự kiện bên ngoài được phân loại là trường đại học.
OOH_VENUE_URBAN_PANELS Địa điểm diễn ra bên ngoài nhà được phân loại là bảng điều khiển ở thành phố.
OOH_VENUE_VETERINARIAN_OFFICES Địa điểm tổ chức hoạt động bên ngoài nhà được phân loại là văn phòng thú y.
OOH_VENUE_WALLS Địa điểm tổ chức sự kiện bên ngoài nhà được phân loại là tường.
OOH_VENUE_OTHER Địa điểm tổ chức bên ngoài nhà được phân loại là địa điểm khác.

ImpressionDataRange

Dữ liệu lượt hiển thị trong một phạm vi ngày.

Biểu diễn dưới dạng JSON 
{
  "impressionDataStartTime": string,
  "impressionDataEndTime": string,
  "impressionDataUnits": [
    {
      object (ImpressionDataUnit)
    }
  ]
}
Trường
impressionDataStartTime

string (Timestamp format)

Bắt buộc. Bắt đầu khoảng thời gian khi dữ liệu lượt hiển thị hợp lệ (bao gồm).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
impressionDataEndTime

string (Timestamp format)

Bắt buộc. Kết thúc khoảng thời gian khi dữ liệu lượt hiển thị hợp lệ (loại trừ).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
impressionDataUnits[]

object (ImpressionDataUnit)

Bắt buộc. Dữ liệu lượt hiển thị trong phạm vi ngày được chỉ định.

ImpressionDataUnit

Dữ liệu lượt hiển thị cho một ngày cụ thể trong tuần và nhiều giờ trong ngày.

Biểu diễn dưới dạng JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "impressions": string
}
Trường
dayOfWeek

enum (DayOfWeek)

Bắt buộc. Ngày trong tuần mà dữ liệu lượt hiển thị đại diện.
hourOfDay

integer

Bắt buộc. Giờ trong ngày mà dữ liệu hiển thị trình bày ở định dạng 24 giờ. Nên ở từ 0 đến 23.
impressions

string (int64 format)

Bắt buộc. Số lượt hiển thị vào ngày cụ thể trong tuần vào các giờ được chỉ định trong ngày.

Phương thức

create

 Tạo đơn vị quảng cáo mới.

delete

 Xoá một đơn vị quảng cáo hiện có.

get

 Truy xuất một đơn vị quảng cáo riêng lẻ.

list

 Liệt kê các đơn vị quảng cáo.

patch

 Cập nhật đơn vị quảng cáo hiện tại.