Method: exchanges.auctionPackages.patch

Обновляет пакет данных аукциона.

HTTP-запрос

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
auctionPackage.name

string

Идентификатор. Относительное имя ресурса для данного аукционного пакета. Должно иметь вид: exchanges/{seller_id}/auctionpackages/{auction_package_id} . Пример: exchanges/1234/auctionPackage/5678 .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Поля
auctionPackage.displayName

string

Обязательно. Отображаемое имя данного аукционного пакета. Должно быть закодировано в UTF-8 и иметь максимальный размер 240 символов.

auctionPackage.status

enum ( DiscoveryObjectStatus )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям DV3.

auctionPackage.description

string

Обязательно. Текст описания данного пакета. Должен быть закодирован в UTF-8 и иметь максимальный размер 2000 символов.

auctionPackage.format

enum ( Format )

Обязательно. Неизменяемо. Базовый тип формата объявления. Обновления после создания не допускаются.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

Необязательно. Прогнозируемая структура инвентаря для данного аукционного пакета. Рекламодатели DV3 могут просматривать и фильтровать эти данные.

auctionPackage.externalDealId

string

Обязательно. Неизменяемо. Идентификатор сделки обмена, используемый в запросах на участие в торгах. Максимум 100 символов. Допустимые символы: буквы и цифры, нижнее подчеркивание, тире и точка. Обновления после создания не допускаются.

auctionPackage.logoUrl

string

Только для вывода. URL-адрес логотипа данного аукционного пакета.

auctionPackage.floorPrice

object ( Money )

Обязательно. Минимальная цена данного аукционного пакета.

auctionPackage.startTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 1 год вперед.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.endTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет неактивным.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.mediumType

enum ( MediumType )

Обязательно. Средний тип аукционного пакета.

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

Необязательно. Если владелец является членом каких-либо недостаточно представленных групп, это необязательно.

updateMask

string ( FieldMask format)

Необязательный параметр. Маска, определяющая, какие поля следует обновлять.

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

auctionPackage.dv3MarketplaceUri

string

Только вывод. Ссылка на аукционный пакет DV360 на торговой площадке.

Ответный текст

В случае успеха тело ответа будет содержать экземпляр объекта AuctionPackage .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

,

Обновляет пакет данных аукциона.

HTTP-запрос

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
auctionPackage.name

string

Идентификатор. Относительное имя ресурса для данного аукционного пакета. Должно иметь вид: exchanges/{seller_id}/auctionpackages/{auction_package_id} . Пример: exchanges/1234/auctionPackage/5678 .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Поля
auctionPackage.displayName

string

Обязательно. Отображаемое имя данного аукционного пакета. Должно быть закодировано в UTF-8 и иметь максимальный размер 240 символов.

auctionPackage.status

enum ( DiscoveryObjectStatus )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям DV3.

auctionPackage.description

string

Обязательно. Текст описания данного пакета. Должен быть закодирован в UTF-8 и иметь максимальный размер 2000 символов.

auctionPackage.format

enum ( Format )

Обязательно. Неизменяемо. Базовый тип формата объявления. Обновления после создания не допускаются.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

Необязательно. Прогнозируемая структура инвентаря для данного аукционного пакета. Рекламодатели DV3 могут просматривать и фильтровать эти данные.

auctionPackage.externalDealId

string

Обязательно. Неизменяемо. Идентификатор сделки обмена, используемый в запросах на участие в торгах. Максимум 100 символов. Допустимые символы: буквы и цифры, нижнее подчеркивание, тире и точка. Обновления после создания не допускаются.

auctionPackage.logoUrl

string

Только для вывода. URL-адрес логотипа данного аукционного пакета.

auctionPackage.floorPrice

object ( Money )

Обязательно. Минимальная цена данного аукционного пакета.

auctionPackage.startTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 1 год вперед.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.endTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет неактивным.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.mediumType

enum ( MediumType )

Обязательно. Средний тип аукционного пакета.

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

Необязательно. Если владелец является членом каких-либо недостаточно представленных групп, это необязательно.

updateMask

string ( FieldMask format)

Необязательный параметр. Маска, определяющая, какие поля следует обновлять.

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

auctionPackage.dv3MarketplaceUri

string

Только вывод. Ссылка на аукционный пакет DV360 на торговой площадке.

Ответный текст

В случае успеха тело ответа будет содержать экземпляр объекта AuctionPackage .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

,

Обновляет пакет данных аукциона.

HTTP-запрос

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
auctionPackage.name

string

Идентификатор. Относительное имя ресурса для данного аукционного пакета. Должно иметь вид: exchanges/{seller_id}/auctionpackages/{auction_package_id} . Пример: exchanges/1234/auctionPackage/5678 .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Поля
auctionPackage.displayName

string

Обязательно. Отображаемое имя данного аукционного пакета. Должно быть закодировано в UTF-8 и иметь максимальный размер 240 символов.

auctionPackage.status

enum ( DiscoveryObjectStatus )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям DV3.

auctionPackage.description

string

Обязательно. Текст описания данного пакета. Должен быть закодирован в UTF-8 и иметь максимальный размер 2000 символов.

auctionPackage.format

enum ( Format )

Обязательно. Неизменяемо. Базовый тип формата объявления. Обновления после создания не допускаются.

auctionPackage.forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

Необязательно. Прогнозируемая структура инвентаря для данного аукционного пакета. Рекламодатели DV3 могут просматривать и фильтровать эти данные.

auctionPackage.externalDealId

string

Обязательно. Неизменяемо. Идентификатор сделки обмена, используемый в запросах на участие в торгах. Максимум 100 символов. Допустимые символы: буквы и цифры, нижнее подчеркивание, тире и точка. Обновления после создания не допускаются.

auctionPackage.logoUrl

string

Только для вывода. URL-адрес логотипа данного аукционного пакета.

auctionPackage.floorPrice

object ( Money )

Обязательно. Минимальная цена данного аукционного пакета.

auctionPackage.startTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 1 год вперед.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.endTime

string ( Timestamp format)

Обязательно. Время, когда данный аукционный пакет станет неактивным.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

auctionPackage.mediumType

enum ( MediumType )

Обязательно. Средний тип аукционного пакета.

auctionPackage.urgOwners[]

enum ( UnderRepresentedGroup )

Необязательно. Если владелец является членом каких-либо недостаточно представленных групп, это необязательно.

updateMask

string ( FieldMask format)

Необязательный параметр. Маска, определяющая, какие поля следует обновлять.

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

auctionPackage.dv3MarketplaceUri

string

Только вывод. Ссылка на аукционный пакет DV360 на торговой площадке.

Ответный текст

В случае успеха тело ответа будет содержать экземпляр объекта AuctionPackage .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .