Method: exchanges.orders.products.patch

Cập nhật sản phẩm.

Yêu cầu HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
product.name

string

Tên tuyến tương đối cho sản phẩm. Do máy chủ tạo. Ví dụ: "exchanges/1234/orders/5678/products/abc". Chỉ có đầu ra.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "etag": string
  },
  "updateMask": string
}
Trường
product.displayName

string

Tên hiển thị của sản phẩm.

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

string

Mã nhận dạng bên ngoài. Đây là mã giao dịch trên hệ thống trao đổi. Tối đa 100 ký tự. Các ký tự được phép sử dụng là chữ-số, dấu gạch dưới, dấu gạch nối và dấu chấm. Không được trùng lặp trên tất cả các sản phẩm. Bắt buộc.
product.transactionType

enum (TransactionType)

Loại giao dịch sản phẩm. Bắt buộc.
product.pricingType

enum (PricingType)

Loại giá của sản phẩm. Bắt buộc.
product.updateTime
(deprecated)

string (Timestamp format)

Dấu thời gian khi sản phẩm được cập nhật lần gần đây nhất.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
product.startTime

string (Timestamp format)

Thời điểm sản phẩm này bắt đầu hoạt động. Phải sớm hơn endTime. Thời gian bắt đầu không được quá 1 năm nữa. Bắt buộc.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
product.endTime

string (Timestamp format)

Thời điểm sản phẩm này không hoạt động. Hiện tại, ngày kết thúc không được muộn hơn năm 2036. Bắt buộc.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
product.rateDetails

object (RateDetails)

Chi tiết về giá. Bắt buộc.
product.creativeConfig[]

object (CreativeConfig)

Yêu cầu về mẫu quảng cáo cho một sản phẩm. Bắt buộc đối với sản phẩm thuộc loại giao dịch đặt trước.
product.makegood
(deprecated)

boolean

Cho biết liệu một sản phẩm có phải là sản phẩm thay thế hay không.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

Thông tin chi tiết về sản phẩm thay thế. Bắt buộc khi sản phẩm là sản phẩm thay thế.
product.creativeSource

enum (CreativeSource)

Nguồn mẫu quảng cáo cho một sản phẩm. Không bắt buộc, mặc định là CREATIVE_SOURCE_ADVERTISER. Bạn không thể thay đổi sau khi tạo sản phẩm.
product.mediumType

enum (MediumType)

Loại phương tiện cho một sản phẩm. Mặc định là DIGITAL nếu không được chỉ định để tương thích ngược. Bạn không thể thay đổi sau khi tạo sản phẩm.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

Không bắt buộc. Cấu hình nhắm mục tiêu theo đối tượng đã chọn được áp dụng ở cấp thoả thuận trên Exchange.
product.targetingCriteria

object (TargetingCriteria)

Chỉ có đầu ra. Tài liệu tham khảo về tiêu chí nhắm mục tiêu sản phẩm. Chỉ áp dụng cho các tình huống Giao dịch tức thì.
product.forecastResult

object (ForecastResult)

Kết quả dự báo sản phẩm. Bắt buộc khi tiêu chí nhắm mục tiêu không để trống và không cung cấp thông tin dự báo. Chỉ áp dụng cho các tình huống Giao dịch tức thì.
product.errorDetails

object (ErrorDetails)

Bạn phải chỉ định thông tin chi tiết về lỗi khi không thể cập nhật một số trường sản phẩm cụ thể. Bắt buộc khi không thể cung cấp kết quả dự đoán do tiêu chí nhắm mục tiêu hoặc không thể cập nhật sản phẩm. Chỉ áp dụng cho các tình huống Giao dịch tức thì.
product.frequencyCap

object (FrequencyCap)

Chỉ có đầu ra. Giới hạn tần suất do người mua chọn. Chỉ áp dụng cho các tình huống Giao dịch tức thì.
product.etag

string

Etag cần được chỉ định khi cập nhật sản phẩm. Bạn chỉ cần chỉ định giá trị này cho nội dung cập nhật nếu trường etag không trống. Chỉ áp dụng cho các tình huống Giao dịch tức thì.
updateMask

string (FieldMask format)

Mặt nạ để kiểm soát những trường cần cập nhật. Bắt buộc.

Đây là danh sách tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Product.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.