REST Resource: curators.dataSegments

Ressource: DataSegment

Definiert eine Kennung für ein Inventarsegment, das von Kuratoren oder Mediaplanern in der Benutzeroberfläche für Deals oder Auktionspakete ausgerichtet werden kann. Die Kuration von Inventar erfolgt durch Kuratoren auf externen Plattformen. -- Nächste ID: 9 --

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // Union field fee can be only one of the following:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
  "userListId": string
}
Felder
name

string

Nicht veränderbar. ID. Die eindeutige ID für das Datensegment. Die Konto-ID entspricht der Konto-ID, mit der das Segment erstellt wurde. Format: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}
createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem das Datensegment erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem das Datensegment zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
state

enum (State)

Nur Ausgabe. Der Status des Datensegments.
Union-Feld fee. Es wird eine Gebühr erhoben, wenn andere Konten dieses Datensegment verwenden. Zum Beispiel, wenn andere Konten dieses Datensegment einem Deal oder Auktionspaket hinzufügen. Der Gebührtyp des Datensegments kann nach dem Festlegen nicht mehr geändert werden. Für fee ist nur einer der folgenden Werte zulässig:
cpmFee

object (Money)

Optional. Eine feste Gebühr pro 1.000 Impressionen. Nach dem Festlegen kann der Währungscode nicht mehr geändert werden.
millipercentOfMediaFee

string (int64 format)

Optional. Die Gebühr wird als Prozentsatz der Kosten für Impressionen erhoben und in Milliprozent angegeben. 1% wird beispielsweise als 1000 dargestellt.
userListId

string

Optional. Nicht veränderbar. Die ID der Nutzerliste, die in diesem Datensegment enthalten ist.

Kuratoren mit einem verknüpften Datenpartnerkonto können ein Datensegment erstellen, das eine Nutzerliste enthält, die dem verknüpften Datenpartnerkonto gehört. Nutzerlisten können über die Data Manager API hochgeladen und verwaltet werden. Wenn Sie eine Nutzerliste mit einem Datensegment verknüpfen, können Sie ein Inventarsegment definieren, das auf einer von Ihnen erstellten Zielgruppe basiert.

Status

Nur Ausgabe. Verwenden Sie die Methoden „Aktivieren“ und „Deaktivieren“, um den Status zu ändern.

Enums
STATE_UNSPECIFIED Standardwert.
ACTIVE Das Datensegment ist aktiv.
INACTIVE Das Datensegment ist inaktiv.
SUSPENDED Das Datensegment ist gesperrt und kann nicht aktiviert werden.

Methoden

activate

 Aktiviert ein Datensegment.

create

 Erstellt ein Datensegment, das dem aufgeführten Kurator gehört.

deactivate

 Deaktiviert ein Datensegment.

get

 Ruft ein Datensegment anhand seines Namens ab.

list

 Listet die Datensegmente auf, die einem Kurator gehören.

patch

 Aktualisiert ein Datensegment.