Method: exchanges.auctionPackages.patch

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

HTTP-запрос

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

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

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

Параметры
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 )

Статус этого аукционного пакета. Пакеты со статусом PAUSED или REMOVED не показываются рекламодателям 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)

Время, когда этот продукт станет активным. Должно быть раньше endTime. Время начала не может быть позже, чем 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 .