REST Resource: networks.customFields

Resource: CustomField

The CustomField resource.

JSON representation
{
  "name": string,
  "customFieldId": string,
  "displayName": string,
  "description": string,
  "status": enum (CustomFieldStatus),
  "entityType": enum (CustomFieldEntityType),
  "dataType": enum (CustomFieldDataType),
  "visibility": enum (CustomFieldVisibility),
  "options": [
    {
      object (CustomFieldOption)
    }
  ]
}
Fields
name

string

Identifier. The resource name of the CustomField. Format: networks/{networkCode}/customFields/{customFieldId}

customFieldId

string (int64 format)

Output only. CustomField ID.

displayName

string

Required. The display name of the CustomField.

This value has a maximum length of 127 characters.

description

string

Optional. The description of the CustomField.

This value has a maximum length of 511 characters.

status

enum (CustomFieldStatus)

Output only. The status of the CustomField.

entityType

enum (CustomFieldEntityType)

Required. The type of entity the CustomField can be applied to.

dataType

enum (CustomFieldDataType)

Required. The data type of the CustomField.

visibility

enum (CustomFieldVisibility)

Required. The visibility of the CustomField.

options[]

object (CustomFieldOption)

Optional. The drop-down options for the CustomField.

Only applicable for CustomField with the drop-down data type.

CustomFieldStatus

The status of the CustomField.

Enums
CUSTOM_FIELD_STATUS_UNSPECIFIED No value specified
ACTIVE The CustomField is active.
INACTIVE The CustomField is inactive.

CustomFieldEntityType

The types of entities that a CustomField can be applied to.

Enums
CUSTOM_FIELD_ENTITY_TYPE_UNSPECIFIED No value specified
LINE_ITEM The CustomField is applied to LineItems.
ORDER The CustomField is applied to Orders.
CREATIVE The CustomField is applied to Creatives.
PROPOSAL The CustomField is applied to Proposals.
PROPOSAL_LINE_ITEM The CustomField is applied to ProposalLineItems.

CustomFieldDataType

The data type for a CustomField.

Enums
CUSTOM_FIELD_DATA_TYPE_UNSPECIFIED No value specified
STRING

A string field

The max length is 255 characters.

NUMBER A number field.
TOGGLE A "Yes" or "No" toggle field.
DROP_DOWN A drop-down field.

CustomFieldVisibility

The visibility level of a CustomField.

Enums
CUSTOM_FIELD_VISIBILITY_UNSPECIFIED No value specified
HIDDEN The CustomField is not visible in the UI and only visible through the API.
READ_ONLY The CustomField is visible in the UI and only editable through the API.
EDITABLE The CustomField is visible and editable in both the API and UI.

CustomFieldOption

An option for a drop-down CustomField.

JSON representation
{
  "customFieldOptionId": string,
  "displayName": string
}
Fields
customFieldOptionId

string (int64 format)

Output only. CustomFieldOption ID.

displayName

string

Required. The display name of the CustomFieldOption.

This value has a maximum length of 127 characters.

Methods

get

API to retrieve a CustomField object.

list

API to retrieve a list of CustomField objects.