Web Service: CustomFieldService

Target Namespace:
https://www.google.com/apis/ads/publisher/v202502

Port CustomFieldServiceInterfacePort Port typeSource code

Location:
https://ads.google.com/apis/ads/publisher/v202502/CustomFieldService
Protocol:
SOAP
Default style:
document
Transport protocol:
SOAP over HTTP
Operations:
  1. createCustomFieldOptionsDetailSource code
  2. createCustomFieldsDetailSource code
  3. getCustomFieldOptionDetailSource code
  4. getCustomFieldsByStatementDetailSource code
  5. performCustomFieldActionDetailSource code
  6. updateCustomFieldOptionsDetailSource code
  7. updateCustomFieldsDetailSource code

Operations

    Port type CustomFieldServiceInterfaceSource code

    1. createCustomFieldOptions
      Description:
      Creates new {@link CustomFieldOption} objects.

      The following fields are required:

      • {@link CustomFieldOption#displayName}
      • {@link CustomFieldOption#customFieldId}
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      Input:
      createCustomFieldOptionsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
      parameters type createCustomFieldOptions
      Creates new {@link CustomFieldOption} objects.

      The following fields are required:

      • {@link CustomFieldOption#displayName}
      • {@link CustomFieldOption#customFieldId}
      • customFieldOptions - optional, unbounded; type CustomFieldOption
        An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.
        • id - optional; type long
          Unique ID of this option. This value is readonly and is assigned by Google.
        • customFieldId - optional; type long
          The id of the custom field this option belongs to.
        • displayName - optional; type string
          The display name of this option.
      Output:
      createCustomFieldOptionsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
      parameters type createCustomFieldOptionsResponse
      • rval - optional, unbounded; type CustomFieldOption
        An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.
        • id - optional; type long
          Unique ID of this option. This value is readonly and is assigned by Google.
        • customFieldId - optional; type long
          The id of the custom field this option belongs to.
        • displayName - optional; type string
          The display name of this option.
      Fault:
      ApiException (wsdlsoap:fault, use = literal)Source code
      ApiException type ApiExceptionFault
      Exception class for holding a list of service errors.
      Base class for exceptions.
      • message - optional; type string
        Error message.
      • errors - optional, unbounded; type ApiError
        The API error base class that provides details about an error that occurred while processing a service request.

        The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

        • fieldPath - optional; type string
          The OGNL field path to identify cause of error.
        • fieldPathElements - optional, unbounded; type FieldPathElement
          A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
          A segment of a field path. Each dot in a field path defines a new segment.
          • field - optional; type string
            The name of a field in lower camelcase. (e.g. "biddingStrategy")
          • index - optional; type int
            For list fields, this is a 0-indexed position in the list. Null for non-list fields.
        • trigger - optional; type string
          The data that caused the error.
        • errorString - optional; type string
          A simple string representation of the error and reason.
        List of errors.
      A fault element of type ApiException.
    2. createCustomFields
      Description:
      Creates new {@link CustomField} objects.

      The following fields are required:

      • {@link CustomField#name}
      • {@link CustomField#entityType}
      • {@link CustomField#dataType}
      • {@link CustomField#visibility}
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      Input:
      createCustomFieldsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
      parameters type createCustomFields
      Creates new {@link CustomField} objects.

      The following fields are required:

      • {@link CustomField#name}
      • {@link CustomField#entityType}
      • {@link CustomField#dataType}
      • {@link CustomField#visibility}
      • customFields - optional, unbounded; type CustomField
        An additional, user-created field on an entity.
        • id - optional; type long
          Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.
        • name - optional; type string
          Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.
        • description - optional; type string
          A description of the custom field. This value is optional. The maximum length is 511 characters
        • isActive - optional; type boolean
          Specifies whether or not the custom fields is active. This attribute is read-only.
        • entityType - optional; type CustomFieldEntityType - type string with restriction - enum { 'LINE_ITEM', 'ORDER', 'CREATIVE', 'PROPOSAL', 'PROPOSAL_LINE_ITEM', 'UNKNOWN' }
          The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
        • dataType - optional; type CustomFieldDataType - type string with restriction - enum { 'STRING', 'NUMBER', 'TOGGLE', 'DROP_DOWN', 'UNKNOWN' }
          The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
        • visibility - optional; type CustomFieldVisibility - type string with restriction - enum { 'UNKNOWN', 'API_ONLY', 'READ_ONLY', 'FULL' }
          How visible/accessible this field is in the UI.
      Output:
      createCustomFieldsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
      parameters type createCustomFieldsResponse
      • rval - optional, unbounded; type CustomField
        An additional, user-created field on an entity.
        • id - optional; type long
          Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.
        • name - optional; type string
          Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.
        • description - optional; type string
          A description of the custom field. This value is optional. The maximum length is 511 characters
        • isActive - optional; type boolean
          Specifies whether or not the custom fields is active. This attribute is read-only.
        • entityType - optional; type CustomFieldEntityType - type string with restriction - enum { 'LINE_ITEM', 'ORDER', 'CREATIVE', 'PROPOSAL', 'PROPOSAL_LINE_ITEM', 'UNKNOWN' }
          The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
        • dataType - optional; type CustomFieldDataType - type string with restriction - enum { 'STRING', 'NUMBER', 'TOGGLE', 'DROP_DOWN', 'UNKNOWN' }
          The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
        • visibility - optional; type CustomFieldVisibility - type string with restriction - enum { 'UNKNOWN', 'API_ONLY', 'READ_ONLY', 'FULL' }
          How visible/accessible this field is in the UI.
      Fault:
      ApiException (wsdlsoap:fault, use = literal)Source code
      ApiException type ApiExceptionFault
      Exception class for holding a list of service errors.
      Base class for exceptions.
      • message - optional; type string
        Error message.
      • errors - optional, unbounded; type ApiError
        The API error base class that provides details about an error that occurred while processing a service request.

        The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

        • fieldPath - optional; type string
          The OGNL field path to identify cause of error.
        • fieldPathElements - optional, unbounded; type FieldPathElement
          A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
          A segment of a field path. Each dot in a field path defines a new segment.
          • field - optional; type string
            The name of a field in lower camelcase. (e.g. "biddingStrategy")
          • index - optional; type int
            For list fields, this is a 0-indexed position in the list. Null for non-list fields.
        • trigger - optional; type string
          The data that caused the error.
        • errorString - optional; type string
          A simple string representation of the error and reason.
        List of errors.
      A fault element of type ApiException.
    3. getCustomFieldOption
      Description:
      Returns the {@link CustomFieldOption} uniquely identified by the given ID.
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      Input:
      getCustomFieldOptionRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
      parameters type getCustomFieldOption
      Returns the {@link CustomFieldOption} uniquely identified by the given ID.
      • customFieldOptionId - optional; type long
      Output:
      getCustomFieldOptionResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
      parameters type getCustomFieldOptionResponse
      • rval - optional; type CustomFieldOption
        An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.
        • id - optional; type long
          Unique ID of this option. This value is readonly and is assigned by Google.
        • customFieldId - optional; type long
          The id of the custom field this option belongs to.
        • displayName - optional; type string
          The display name of this option.
      Fault:
      ApiException (wsdlsoap:fault, use = literal)Source code
      ApiException type ApiExceptionFault
      Exception class for holding a list of service errors.
      Base class for exceptions.
      • message - optional; type string
        Error message.
      • errors - optional, unbounded; type ApiError
        The API error base class that provides details about an error that occurred while processing a service request.

        The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

        • fieldPath - optional; type string
          The OGNL field path to identify cause of error.
        • fieldPathElements - optional, unbounded; type FieldPathElement
          A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
          A segment of a field path. Each dot in a field path defines a new segment.
          • field - optional; type string
            The name of a field in lower camelcase. (e.g. "biddingStrategy")
          • index - optional; type int
            For list fields, this is a 0-indexed position in the list. Null for non-list fields.
        • trigger - optional; type string
          The data that caused the error.
        • errorString - optional; type string
          A simple string representation of the error and reason.
        List of errors.
      A fault element of type ApiException.
    4. getCustomFieldsByStatement
      Description:
      Gets a {@link CustomFieldPage} of {@link CustomField} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering:
      PQL Property Object Property
      {@code id} {@link CustomField#id}
      {@code entityType} {@link CustomField#entityType}
      {@code name} {@link CustomField#name}
      {@code isActive} {@link CustomField#isActive}
      {@code visibility} {@link CustomField#visibility}
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      Input:
      getCustomFieldsByStatementRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
      parameters type getCustomFieldsByStatement
      Gets a {@link CustomFieldPage} of {@link CustomField} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering:
      PQL Property Object Property
      {@code id} {@link CustomField#id}
      {@code entityType} {@link CustomField#entityType}
      {@code name} {@link CustomField#name}
      {@code isActive} {@link CustomField#isActive}
      {@code visibility} {@link CustomField#visibility}
      • filterStatement - optional; type Statement
        Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary.

        An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}.

        Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query.

        An example of such a query might be {@code "WHERE id = :idValue"}.

        Statements also support use of the LIKE keyword. This provides wildcard string matching.

        An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}.

        The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}.
        • query - optional; type string
          Holds the query in PQL syntax. The syntax is:
          [WHERE {[AND | OR] ...}]
          [ORDER BY [ASC | DESC]]
          [LIMIT {[,] } | { OFFSET }]


               := {< | <= | > | >= | = | != }

               := {< | <= | > | >= | = | != }
          := IN
          := IS NULL
          := LIKE
          := :

        • values - optional, unbounded; type String_ValueMapEntry
          Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable.

          In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}.

          This represents an entry in a map with a key of type String and value of type Value.
          • key - optional; type string
          • value - optional; type Value
            {@code Value} represents a value.
        Output:
        getCustomFieldsByStatementResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
        parameters type getCustomFieldsByStatementResponse
        • rval - optional; type CustomFieldPage
          Captures a page of {@link CustomField} objects.
          • totalResultSetSize - optional; type int
            The size of the total result set to which this page belongs.
          • startIndex - optional; type int
            The absolute index in the total result set on which this page begins.
          • results - optional, unbounded; type CustomField
            An additional, user-created field on an entity.
            • id - optional; type long
              Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.
            • name - optional; type string
              Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.
            • description - optional; type string
              A description of the custom field. This value is optional. The maximum length is 511 characters
            • isActive - optional; type boolean
              Specifies whether or not the custom fields is active. This attribute is read-only.
            • entityType - optional; type CustomFieldEntityType - type string with restriction - enum { 'LINE_ITEM', 'ORDER', 'CREATIVE', 'PROPOSAL', 'PROPOSAL_LINE_ITEM', 'UNKNOWN' }
              The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • dataType - optional; type CustomFieldDataType - type string with restriction - enum { 'STRING', 'NUMBER', 'TOGGLE', 'DROP_DOWN', 'UNKNOWN' }
              The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • visibility - optional; type CustomFieldVisibility - type string with restriction - enum { 'UNKNOWN', 'API_ONLY', 'READ_ONLY', 'FULL' }
              How visible/accessible this field is in the UI.
            The collection of custom fields contained within this page.
        Fault:
        ApiException (wsdlsoap:fault, use = literal)Source code
        ApiException type ApiExceptionFault
        Exception class for holding a list of service errors.
        Base class for exceptions.
        • message - optional; type string
          Error message.
        • errors - optional, unbounded; type ApiError
          The API error base class that provides details about an error that occurred while processing a service request.

          The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

          • fieldPath - optional; type string
            The OGNL field path to identify cause of error.
          • fieldPathElements - optional, unbounded; type FieldPathElement
            A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
            A segment of a field path. Each dot in a field path defines a new segment.
            • field - optional; type string
              The name of a field in lower camelcase. (e.g. "biddingStrategy")
            • index - optional; type int
              For list fields, this is a 0-indexed position in the list. Null for non-list fields.
          • trigger - optional; type string
            The data that caused the error.
          • errorString - optional; type string
            A simple string representation of the error and reason.
          List of errors.
        A fault element of type ApiException.
      • performCustomFieldAction
        Description:
        Performs actions on {@link CustomField} objects that match the given {@link Statement#query}.
        Operation type:
        Request-response. The endpoint receives a message, and sends a correlated message.
        Input:
        performCustomFieldActionRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
        parameters type performCustomFieldAction
        Performs actions on {@link CustomField} objects that match the given {@link Statement#query}.
        • customFieldAction - optional; type CustomFieldAction
          Represents the actions that can be performed on {@link CustomField} objects.
          • filterStatement - optional; type Statement
            Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary.

            An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}.

            Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query.

            An example of such a query might be {@code "WHERE id = :idValue"}.

            Statements also support use of the LIKE keyword. This provides wildcard string matching.

            An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}.

            The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}.
            • query - optional; type string
              Holds the query in PQL syntax. The syntax is:
              [WHERE {[AND | OR] ...}]
              [ORDER BY [ASC | DESC]]
              [LIMIT {[,] } | { OFFSET }]


                   := {< | <= | > | >= | = | != }

                   := {< | <= | > | >= | = | != }
              := IN
              := IS NULL
              := LIKE
              := :

            • values - optional, unbounded; type String_ValueMapEntry
              Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable.

              In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}.

              This represents an entry in a map with a key of type String and value of type Value.
              • key - optional; type string
              • value - optional; type Value
                {@code Value} represents a value.
          Output:
          performCustomFieldActionResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
          parameters type performCustomFieldActionResponse
          • rval - optional; type UpdateResult
            Represents the result of performing an action on objects.
            • numChanges - optional; type int
              The number of objects that were changed as a result of performing the action.
          Fault:
          ApiException (wsdlsoap:fault, use = literal)Source code
          ApiException type ApiExceptionFault
          Exception class for holding a list of service errors.
          Base class for exceptions.
          • message - optional; type string
            Error message.
          • errors - optional, unbounded; type ApiError
            The API error base class that provides details about an error that occurred while processing a service request.

            The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

            • fieldPath - optional; type string
              The OGNL field path to identify cause of error.
            • fieldPathElements - optional, unbounded; type FieldPathElement
              A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
              A segment of a field path. Each dot in a field path defines a new segment.
              • field - optional; type string
                The name of a field in lower camelcase. (e.g. "biddingStrategy")
              • index - optional; type int
                For list fields, this is a 0-indexed position in the list. Null for non-list fields.
            • trigger - optional; type string
              The data that caused the error.
            • errorString - optional; type string
              A simple string representation of the error and reason.
            List of errors.
          A fault element of type ApiException.
        • updateCustomFieldOptions
          Description:
          Updates the specified {@link CustomFieldOption} objects.
          Operation type:
          Request-response. The endpoint receives a message, and sends a correlated message.
          Input:
          updateCustomFieldOptionsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
          parameters type updateCustomFieldOptions
          Updates the specified {@link CustomFieldOption} objects.
          • customFieldOptions - optional, unbounded; type CustomFieldOption
            An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.
            • id - optional; type long
              Unique ID of this option. This value is readonly and is assigned by Google.
            • customFieldId - optional; type long
              The id of the custom field this option belongs to.
            • displayName - optional; type string
              The display name of this option.
          Output:
          updateCustomFieldOptionsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
          parameters type updateCustomFieldOptionsResponse
          • rval - optional, unbounded; type CustomFieldOption
            An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.
            • id - optional; type long
              Unique ID of this option. This value is readonly and is assigned by Google.
            • customFieldId - optional; type long
              The id of the custom field this option belongs to.
            • displayName - optional; type string
              The display name of this option.
          Fault:
          ApiException (wsdlsoap:fault, use = literal)Source code
          ApiException type ApiExceptionFault
          Exception class for holding a list of service errors.
          Base class for exceptions.
          • message - optional; type string
            Error message.
          • errors - optional, unbounded; type ApiError
            The API error base class that provides details about an error that occurred while processing a service request.

            The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

            • fieldPath - optional; type string
              The OGNL field path to identify cause of error.
            • fieldPathElements - optional, unbounded; type FieldPathElement
              A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
              A segment of a field path. Each dot in a field path defines a new segment.
              • field - optional; type string
                The name of a field in lower camelcase. (e.g. "biddingStrategy")
              • index - optional; type int
                For list fields, this is a 0-indexed position in the list. Null for non-list fields.
            • trigger - optional; type string
              The data that caused the error.
            • errorString - optional; type string
              A simple string representation of the error and reason.
            List of errors.
          A fault element of type ApiException.
        • updateCustomFields
          Description:
          Updates the specified {@link CustomField} objects.
          Operation type:
          Request-response. The endpoint receives a message, and sends a correlated message.
          Input:
          updateCustomFieldsRequest (wsdlsoap:header, use = literal, part = RequestHeader)Source code
          parameters type updateCustomFields
          Updates the specified {@link CustomField} objects.
          • customFields - optional, unbounded; type CustomField
            An additional, user-created field on an entity.
            • id - optional; type long
              Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.
            • name - optional; type string
              Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.
            • description - optional; type string
              A description of the custom field. This value is optional. The maximum length is 511 characters
            • isActive - optional; type boolean
              Specifies whether or not the custom fields is active. This attribute is read-only.
            • entityType - optional; type CustomFieldEntityType - type string with restriction - enum { 'LINE_ITEM', 'ORDER', 'CREATIVE', 'PROPOSAL', 'PROPOSAL_LINE_ITEM', 'UNKNOWN' }
              The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • dataType - optional; type CustomFieldDataType - type string with restriction - enum { 'STRING', 'NUMBER', 'TOGGLE', 'DROP_DOWN', 'UNKNOWN' }
              The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • visibility - optional; type CustomFieldVisibility - type string with restriction - enum { 'UNKNOWN', 'API_ONLY', 'READ_ONLY', 'FULL' }
              How visible/accessible this field is in the UI.
          Output:
          updateCustomFieldsResponse (wsdlsoap:header, use = literal, part = ResponseHeader)Source code
          parameters type updateCustomFieldsResponse
          • rval - optional, unbounded; type CustomField
            An additional, user-created field on an entity.
            • id - optional; type long
              Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.
            • name - optional; type string
              Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.
            • description - optional; type string
              A description of the custom field. This value is optional. The maximum length is 511 characters
            • isActive - optional; type boolean
              Specifies whether or not the custom fields is active. This attribute is read-only.
            • entityType - optional; type CustomFieldEntityType - type string with restriction - enum { 'LINE_ITEM', 'ORDER', 'CREATIVE', 'PROPOSAL', 'PROPOSAL_LINE_ITEM', 'UNKNOWN' }
              The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • dataType - optional; type CustomFieldDataType - type string with restriction - enum { 'STRING', 'NUMBER', 'TOGGLE', 'DROP_DOWN', 'UNKNOWN' }
              The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.
            • visibility - optional; type CustomFieldVisibility - type string with restriction - enum { 'UNKNOWN', 'API_ONLY', 'READ_ONLY', 'FULL' }
              How visible/accessible this field is in the UI.
          Fault:
          ApiException (wsdlsoap:fault, use = literal)Source code
          ApiException type ApiExceptionFault
          Exception class for holding a list of service errors.
          Base class for exceptions.
          • message - optional; type string
            Error message.
          • errors - optional, unbounded; type ApiError
            The API error base class that provides details about an error that occurred while processing a service request.

            The OGNL field path is provided for parsers to identify the request data element that may have caused the error.

            • fieldPath - optional; type string
              The OGNL field path to identify cause of error.
            • fieldPathElements - optional, unbounded; type FieldPathElement
              A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.
              A segment of a field path. Each dot in a field path defines a new segment.
              • field - optional; type string
                The name of a field in lower camelcase. (e.g. "biddingStrategy")
              • index - optional; type int
                For list fields, this is a 0-indexed position in the list. Null for non-list fields.
            • trigger - optional; type string
              The data that caused the error.
            • errorString - optional; type string
              A simple string representation of the error and reason.
            List of errors.
          A fault element of type ApiException.

      WSDL source code

      <?xml version="1.0"?>
      <!-- Generated file, do not edit -->
      <!-- Copyright 2025 Google Inc. All Rights Reserved -->
      <wsdl:definitions targetNamespace="https://www.google.com/apis/ads/publisher/v202502"
      xmlns:tns="https://www.google.com/apis/ads/publisher/v202502"
      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
      >
      <wsdl:types>
      <schema elementFormDefault="qualified" jaxb:version="1.0" targetNamespace="https://www.google.com/apis/ads/publisher/v202502"
      xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
      >
      <complexType abstract="true" name="ObjectValue">
      <annotation>
      <documentation>Contains an object value. <p> <b>This object is experimental! <code>ObjectValue</code> is an experimental, innovative, and rapidly changing new feature for Ad Manager. Unfortunately, being on the bleeding edge means that we may make backwards-incompatible changes to <code>ObjectValue</code>. We will inform the community when this feature is no longer experimental.</b></documentation>
      </annotation>
      </complexType>
      <complexType name="ActivateCustomFields">
      <annotation>
      <documentation>The action used for activating {@link CustomField} objects.</documentation>
      </annotation>
      </complexType>
      <complexType abstract="true" name="ApiError">
      <annotation>
      <documentation>The API error base class that provides details about an error that occurred while processing a service request. <p>The OGNL field path is provided for parsers to identify the request data element that may have caused the error.</p></documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="fieldPath" type="xsd:string">
      <annotation>
      <documentation>The OGNL field path to identify cause of error.</documentation>
      </annotation>
      </element>
      <element maxOccurs="unbounded" minOccurs="0" name="fieldPathElements" type="tns:FieldPathElement">
      <annotation>
      <documentation>A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="trigger" type="xsd:string">
      <annotation>
      <documentation>The data that caused the error.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="errorString" type="xsd:string">
      <annotation>
      <documentation>A simple string representation of the error and reason.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="ApiException">
      <annotation>
      <documentation>Exception class for holding a list of service errors.</documentation>
      </annotation>
      </complexType>
      <complexType name="ApplicationException">
      <annotation>
      <documentation>Base class for exceptions.</documentation>
      </annotation>
      </complexType>
      <complexType name="AuthenticationError">
      <annotation>
      <documentation>An error for an exception that occurred when authenticating.</documentation>
      </annotation>
      </complexType>
      <complexType name="BooleanValue">
      <annotation>
      <documentation>Contains a boolean value.</documentation>
      </annotation>
      </complexType>
      <complexType name="CommonError">
      <annotation>
      <documentation>A place for common errors that can be used across services.</documentation>
      </annotation>
      </complexType>
      <complexType name="CustomFieldAction">
      <annotation>
      <documentation>Represents the actions that can be performed on {@link CustomField} objects.</documentation>
      </annotation>
      </complexType>
      <complexType name="CustomField">
      <annotation>
      <documentation>An additional, user-created field on an entity.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="id" type="xsd:long">
      <annotation>
      <documentation>Unique ID of the {@code CustomField}. This value is readonly and is assigned by Google.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="name" type="xsd:string">
      <annotation>
      <documentation>Name of the {@code CustomField}. This is value is required to create a custom field. The max length is 127 characters.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="description" type="xsd:string">
      <annotation>
      <documentation>A description of the custom field. This value is optional. The maximum length is 511 characters</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="isActive" type="xsd:boolean">
      <annotation>
      <documentation>Specifies whether or not the custom fields is active. This attribute is read-only.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="entityType" type="tns:CustomFieldEntityType">
      <annotation>
      <documentation>The type of entity that this custom field is associated with. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="dataType" type="tns:CustomFieldDataType">
      <annotation>
      <documentation>The type of data this custom field contains. This attribute is read-only if there exists a {@link CustomFieldValue} for this field.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="visibility" type="tns:CustomFieldVisibility">
      <annotation>
      <documentation>How visible/accessible this field is in the UI.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="CustomFieldError">
      <annotation>
      <documentation>Errors specific to editing custom fields</documentation>
      </annotation>
      <complexContent></complexContent>
      </complexType>
      <complexType name="CustomFieldOption">
      <annotation>
      <documentation>An option represents a permitted value for a custom field that has a {@link CustomField#dataType} of {@link CustomFieldDataType#DROP_DOWN}.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="id" type="xsd:long">
      <annotation>
      <documentation>Unique ID of this option. This value is readonly and is assigned by Google.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="customFieldId" type="xsd:long">
      <annotation>
      <documentation>The id of the custom field this option belongs to.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="displayName" type="xsd:string">
      <annotation>
      <documentation>The display name of this option.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="CustomFieldPage">
      <annotation>
      <documentation>Captures a page of {@link CustomField} objects.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="totalResultSetSize" type="xsd:int">
      <annotation>
      <documentation>The size of the total result set to which this page belongs.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="startIndex" type="xsd:int">
      <annotation>
      <documentation>The absolute index in the total result set on which this page begins.</documentation>
      </annotation>
      </element>
      <element maxOccurs="unbounded" minOccurs="0" name="results" type="tns:CustomField">
      <annotation>
      <documentation>The collection of custom fields contained within this page.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="Date">
      <annotation>
      <documentation>Represents a date.</documentation>
      </annotation>
      </complexType>
      <complexType name="DateTimeValue">
      <annotation>
      <documentation>Contains a date-time value.</documentation>
      </annotation>
      <complexContent></complexContent>
      </complexType>
      <complexType name="DateValue">
      <annotation>
      <documentation>Contains a date value.</documentation>
      </annotation>
      <complexContent></complexContent>
      </complexType>
      <complexType name="DeactivateCustomFields">
      <annotation>
      <documentation>The action used for deactivating {@link CustomField} objects.</documentation>
      </annotation>
      </complexType>
      <complexType name="DropDownCustomField">
      <annotation>
      <documentation>A custom field that has the drop-down data type.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:CustomField">
      <sequence>
      <element maxOccurs="unbounded" minOccurs="0" name="options" type="tns:CustomFieldOption">
      <annotation>
      <documentation>The options allowed for this custom field. This is read only.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="EntityLimitReachedError">
      <annotation>
      <documentation>An error that occurs when creating an entity if the limit on the number of allowed entities for a network has already been reached.</documentation>
      </annotation>
      </complexType>
      <complexType name="FeatureError">
      <annotation>
      <documentation>Errors related to feature management. If you attempt using a feature that is not available to the current network you'll receive a FeatureError with the missing feature as the trigger.</documentation>
      </annotation>
      </complexType>
      <complexType name="FieldPathElement">
      <annotation>
      <documentation>A segment of a field path. Each dot in a field path defines a new segment.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="field" type="xsd:string">
      <annotation>
      <documentation>The name of a field in lower camelcase. (e.g. "biddingStrategy")</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="index" type="xsd:int">
      <annotation>
      <documentation>For list fields, this is a 0-indexed position in the list. Null for non-list fields.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="InternalApiError">
      <annotation>
      <documentation>Indicates that a server-side error has occured. {@code InternalApiError}s are generally not the result of an invalid request or message sent by the client.</documentation>
      </annotation>
      <complexContent></complexContent>
      </complexType>
      <complexType name="NotNullError">
      <annotation>
      <documentation>Caused by supplying a null value for an attribute that cannot be null.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:ApiError">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="reason" type="tns:NotNullError.Reason">
      <annotation>
      <documentation>The error reason represented by an enum.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="NullError">
      <annotation>
      <documentation>Errors associated with violation of a NOT NULL check.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:ApiError">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="reason" type="tns:NullError.Reason">
      <annotation>
      <documentation>The error reason represented by an enum.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="NumberValue">
      <annotation>
      <documentation>Contains a numeric value.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:Value">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="value" type="xsd:string">
      <annotation>
      <documentation>The numeric value represented as a string.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="ParseError">
      <annotation>
      <documentation>Lists errors related to parsing.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:ApiError">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="reason" type="tns:ParseError.Reason">
      <annotation>
      <documentation>The error reason represented by an enum.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="PublisherQueryLanguageContextError">
      <annotation>
      <documentation>An error that occurs while executing a PQL query contained in a {@link Statement} object.</documentation>
      </annotation>
      </complexType>
      <complexType name="PublisherQueryLanguageSyntaxError">
      <annotation>
      <documentation>An error that occurs while parsing a PQL query contained in a {@link Statement} object.</documentation>
      </annotation>
      </complexType>
      <complexType name="QuotaError">
      <annotation>
      <documentation>Describes a client-side error on which a user is attempting to perform an action to which they have no quota remaining.</documentation>
      </annotation>
      </complexType>
      <complexType name="RequiredCollectionError">
      <annotation>
      <documentation>A list of all errors to be used for validating sizes of collections.</documentation>
      </annotation>
      </complexType>
      <complexType name="RequiredError">
      <annotation>
      <documentation>Errors due to missing required field.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:ApiError">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="reason" type="tns:RequiredError.Reason">
      <annotation>
      <documentation>The error reason represented by an enum.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="SetValue">
      <annotation>
      <documentation>Contains a set of {@link Value Values}. May not contain duplicates.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:Value">
      <sequence>
      <element maxOccurs="unbounded" minOccurs="0" name="values" type="tns:Value">
      <annotation>
      <documentation>The values. They must all be the same type of {@code Value} and not contain duplicates.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="SoapRequestHeader">
      <annotation>
      <documentation>Represents the SOAP request header used by API requests.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="networkCode" type="xsd:string">
      <annotation>
      <documentation>The network code to use in the context of a request.</documentation>
      </annotation>
      </element>
      <element maxOccurs="1" minOccurs="0" name="applicationName" type="xsd:string">
      <annotation>
      <documentation>The name of client library application.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="Statement">
      <annotation>
      <documentation>Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary. <p> An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}. </p> <p> Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query. </p> <p> An example of such a query might be {@code "WHERE id = :idValue"}. </p> <p> Statements also support use of the LIKE keyword. This provides wildcard string matching. </p> <p> An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}. </p> The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="query" type="xsd:string">
      <annotation>
      <documentation>Holds the query in PQL syntax. The syntax is:<br> <code>[WHERE <condition> {[AND | OR] <condition> ...}]</code><br> <code>[ORDER BY <property> [ASC | DESC]]</code><br> <code>[LIMIT {[<offset>,] <count>} | {<count> OFFSET <offset>}]</code><br> <p> <code><condition></code><br> &nbsp;&nbsp;&nbsp;&nbsp; <code>:= <property> {< | <= | > | >= | = | != } <value></code><br> <code><condition></code><br> &nbsp;&nbsp;&nbsp;&nbsp; <code>:= <property> {< | <= | > | >= | = | != } <bind variable></code><br> <code><condition> := <property> IN <list></code><br> <code><condition> := <property> IS NULL</code><br> <code><condition> := <property> LIKE <wildcard%match></code><br> <code><bind variable> := :<name></code><br> </p></documentation>
      </annotation>
      </element>
      <element maxOccurs="unbounded" minOccurs="0" name="values" type="tns:String_ValueMapEntry">
      <annotation>
      <documentation>Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable. <p> In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}. </p></documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType name="StatementError">
      <annotation>
      <documentation>An error that occurs while parsing {@link Statement} objects.</documentation>
      </annotation>
      <complexContent>
      <extension base="tns:ApiError">
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="reason" type="tns:StatementError.Reason">
      <annotation>
      <documentation>The error reason represented by an enum.</documentation>
      </annotation>
      </element>
      </sequence>
      </extension>
      </complexContent>
      </complexType>
      <complexType name="StringFormatError">
      <annotation>
      <documentation>A list of error code for reporting invalid content of input strings.</documentation>
      </annotation>
      </complexType>
      <complexType name="StringLengthError">
      <annotation>
      <documentation>Errors for Strings which do not meet given length constraints.</documentation>
      </annotation>
      </complexType>
      <complexType name="TextValue">
      <annotation>
      <documentation>Contains a string value.</documentation>
      </annotation>
      </complexType>
      <complexType name="TypeError">
      <annotation>
      <documentation>An error for a field which is an invalid type.</documentation>
      </annotation>
      </complexType>
      <complexType name="UniqueError">
      <annotation>
      <documentation>An error for a field which must satisfy a uniqueness constraint</documentation>
      </annotation>
      </complexType>
      <complexType name="UpdateResult">
      <annotation>
      <documentation>Represents the result of performing an action on objects.</documentation>
      </annotation>
      <sequence>
      <element maxOccurs="1" minOccurs="0" name="numChanges" type="xsd:int">
      <annotation>
      <documentation>The number of objects that were changed as a result of performing the action.</documentation>
      </annotation>
      </element>
      </sequence>
      </complexType>
      <complexType abstract="true" name="Value">
      <annotation>
      <documentation>{@code Value} represents a value.</documentation>
      </annotation>
      </complexType>
      <simpleType name="ApiVersionError.Reason">
      <restriction base="xsd:string">
      <enumeration value="UPDATE_TO_NEWER_VERSION">
      <annotation>
      <documentation>Indicates that the operation is not allowed in the version the request was made in.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="AuthenticationError.Reason">
      <restriction base="xsd:string">
      <enumeration value="AMBIGUOUS_SOAP_REQUEST_HEADER">
      <annotation>
      <documentation>The SOAP message contains a request header with an ambiguous definition of the authentication header fields. This means either the {@code authToken} and {@code oAuthToken} fields were both null or both were specified. Exactly one value should be specified with each request.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="INVALID_EMAIL">
      <annotation>
      <documentation>The login provided is invalid.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="AUTHENTICATION_FAILED">
      <annotation>
      <documentation>Tried to authenticate with provided information, but failed.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="INVALID_OAUTH_SIGNATURE">
      <annotation>
      <documentation>The OAuth provided is invalid.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="INVALID_SERVICE">
      <annotation>
      <documentation>The specified service to use was not recognized.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="MISSING_SOAP_REQUEST_HEADER">
      <annotation>
      <documentation>The SOAP message is missing a request header with an {@code authToken} and optional {@code networkCode}.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="MISSING_AUTHENTICATION_HTTP_HEADER">
      <annotation>
      <documentation>The HTTP request is missing a request header with an {@code authToken}</documentation>
      </annotation>
      </enumeration>
      <enumeration value="MISSING_AUTHENTICATION">
      <annotation>
      <documentation>The request is missing an {@code authToken}</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NETWORK_API_ACCESS_DISABLED">
      <annotation>
      <documentation>The network does not have API access enabled.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NO_NETWORKS_TO_ACCESS">
      <annotation>
      <documentation>The user is not associated with any network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NETWORK_NOT_FOUND">
      <annotation>
      <documentation>No network for the given {@code networkCode} was found.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NETWORK_CODE_REQUIRED">
      <annotation>
      <documentation>The user has access to more than one network, but did not provide a {@code networkCode}.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="CONNECTION_ERROR">
      <annotation>
      <documentation>An error happened on the server side during connection to authentication service.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK">
      <annotation>
      <documentation>The user tried to create a test network using an account that already is associated with a network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNDER_INVESTIGATION">
      <annotation>
      <documentation>The account is blocked and under investigation by the collections team. Please contact Google for more information.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CollectionSizeError.Reason">
      <restriction base="xsd:string">
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CommonError.Reason">
      <annotation>
      <documentation>Describes reasons for common errors</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="NOT_FOUND">
      <annotation>
      <documentation>Indicates that an attempt was made to retrieve an entity that does not exist.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ALREADY_EXISTS">
      <annotation>
      <documentation>Indicates that an attempt was made to create an entity that already exists.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NOT_APPLICABLE">
      <annotation>
      <documentation>Indicates that a value is not applicable for given use case.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="DUPLICATE_OBJECT">
      <annotation>
      <documentation>Indicates that two elements in the collection were identical.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="CANNOT_UPDATE">
      <annotation>
      <documentation>Indicates that an attempt was made to change an immutable field.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNSUPPORTED_OPERATION">
      <annotation>
      <documentation>Indicates that the requested operation is not supported.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="CONCURRENT_MODIFICATION">
      <annotation>
      <documentation>Indicates that another request attempted to update the same data in the same network at about the same time. Please wait and try the request again.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CustomFieldDataType">
      <annotation>
      <documentation>The data types allowed for {@link CustomField} objects.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="STRING">
      <annotation>
      <documentation>A string field. The max length is 255 characters.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="NUMBER">
      <annotation>
      <documentation>A number field.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="TOGGLE">
      <annotation>
      <documentation>A boolean field. Values may be "true", "false", or empty.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="DROP_DOWN">
      <annotation>
      <documentation>A drop-down field. Values may only be the ids of {@link CustomFieldOption} objects.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CustomFieldEntityType">
      <annotation>
      <documentation>Entity types recognized by custom fields</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="LINE_ITEM">
      <annotation>
      <documentation>Represents the {@link LineItem} type.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ORDER">
      <annotation>
      <documentation>Represents the {@link Order} type.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="CREATIVE">
      <annotation>
      <documentation>Represents the {@link Creative} type.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="PROPOSAL">
      <annotation>
      <documentation>Represents the {@link Proposal} type.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="PROPOSAL_LINE_ITEM">
      <annotation>
      <documentation>Represents the {@link ProposalLineItem} type.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CustomFieldError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="INVALID_CUSTOM_FIELD_FOR_OPTION">
      <annotation>
      <documentation>An attempt was made to create a {@link CustomFieldOption} for a {@link CustomField} that does not have {@link CustomFieldDataType#DROPDOWN}.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="CustomFieldVisibility">
      <annotation>
      <documentation>The visibility levels of a custom field.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="API_ONLY">
      <annotation>
      <documentation>Only visible through the API.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="READ_ONLY">
      <annotation>
      <documentation>Visible in the UI, but only editable through the API</documentation>
      </annotation>
      </enumeration>
      <enumeration value="FULL">
      <annotation>
      <documentation>Visible and editable both in the API and the UI.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="EntityLimitReachedError.Reason">
      <annotation>
      <documentation>The reasons for the entity limit reached error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="CUSTOM_TARGETING_VALUES_LIMIT_REACHED">
      <annotation>
      <documentation>The number of custom targeting values exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="AD_EXCLUSION_RULES_LIMIT_REACHED">
      <annotation>
      <documentation>The number of ad exclusion rules exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="FIRST_PARTY_AUDIENCE_SEGMENTS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of first party audience segments exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="PLACEMENTS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of active placements exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="LINE_ITEMS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of line items excceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ACTIVE_LINE_ITEMS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of active line items exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="DAI_ENCODING_PROFILES_LIMIT_REACHED">
      <annotation>
      <documentation>The number of not-archived encoding profiles exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="TRAFFIC_FORECAST_SEGMENTS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of traffic forecast segments exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="FORECAST_ADJUSTMENTS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of forecast adjustments exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ACTIVE_EXPERIMENTS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of active experiments exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="SITES_LIMIT_REACHED">
      <annotation>
      <documentation>The number of sites exceeds the max number allowed in the network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="USER_TEAMS_LIMIT_REACHED">
      <annotation>
      <documentation>The number of teams on the user exceeds the max number allowed.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ACTIVE_TARGETING_PRESETS_LIMIT_REACHED">
      <annotation>
      <documentation>The count of active targeting presets exceeds the limit.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="FeatureError.Reason">
      <restriction base="xsd:string">
      <enumeration value="MISSING_FEATURE">
      <annotation>
      <documentation>A feature is being used that is not enabled on the current network.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="InternalApiError.Reason">
      <annotation>
      <documentation>The single reason for the internal API error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="UNEXPECTED_INTERNAL_API_ERROR">
      <annotation>
      <documentation>API encountered an unexpected internal error.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="TRANSIENT_ERROR">
      <annotation>
      <documentation>A temporary error occurred during the request. Please retry.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The cause of the error is not known or only defined in newer versions.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="DOWNTIME">
      <annotation>
      <documentation>The API is currently unavailable for a planned downtime.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="ERROR_GENERATING_RESPONSE">
      <annotation>
      <documentation>Mutate succeeded but server was unable to build response. Client should not retry mutate.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="NotNullError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="ARG1_NULL">
      <annotation>
      <documentation>Assuming that a method will not have more than 3 arguments, if it does, return NULL</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="NullError.Reason">
      <annotation>
      <documentation>The reasons for the validation error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="NULL_CONTENT">
      <annotation>
      <documentation>Specified list/container must not contain any null elements</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="ParseError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="UNPARSABLE">
      <annotation>
      <documentation>Indicates an error in parsing an attribute.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="PermissionError.Reason">
      <annotation>
      <documentation>Describes reasons for permission errors.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="PERMISSION_DENIED">
      <annotation>
      <documentation>User does not have the required permission for the request.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="PublisherQueryLanguageContextError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="UNEXECUTABLE">
      <annotation>
      <documentation>Indicates that there was an error executing the PQL.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="PublisherQueryLanguageSyntaxError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="UNPARSABLE">
      <annotation>
      <documentation>Indicates that there was a PQL syntax error.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="QuotaError.Reason">
      <restriction base="xsd:string">
      <enumeration value="EXCEEDED_QUOTA">
      <annotation>
      <documentation>The number of requests made per second is too high and has exceeded the allowable limit. The recommended approach to handle this error is to wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. <p>Another way to mitigate this error is to limit requests to 8 per second for Ad Manager 360 accounts, or 2 per second for Ad Manager accounts. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="REPORT_JOB_LIMIT">
      <annotation>
      <documentation>This user has exceeded the allowed number of new report requests per hour (this includes both reports run via the UI and reports run via {@link ReportService#runReportJob}). The recommended approach to handle this error is to wait about 10 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. <p>Another way to mitigate this error is to limit the number of new report requests to 250 per hour per user. Once again, this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="SEGMENT_POPULATION_LIMIT">
      <annotation>
      <documentation>This network has exceeded the allowed number of identifiers uploaded within a 24 hour period. The recommended approach to handle this error is to wait 30 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="RequiredCollectionError.Reason">
      <restriction base="xsd:string">
      <enumeration value="REQUIRED">
      <annotation>
      <documentation>A required collection is missing.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="TOO_LARGE">
      <annotation>
      <documentation>Collection size is too large.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="TOO_SMALL">
      <annotation>
      <documentation>Collection size is too small.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="RequiredError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="REQUIRED">
      <annotation>
      <documentation>Missing required field.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="ServerError.Reason">
      <annotation>
      <documentation>Describes reasons for server errors</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="SERVER_ERROR">
      <annotation>
      <documentation>Indicates that an unexpected error occured.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="SERVER_BUSY">
      <annotation>
      <documentation>Indicates that the server is currently experiencing a high load. Please wait and try your request again.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="StatementError.Reason">
      <restriction base="xsd:string">
      <enumeration value="VARIABLE_NOT_BOUND_TO_VALUE">
      <annotation>
      <documentation>A bind variable has not been bound to a value.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="StringFormatError.Reason">
      <annotation>
      <documentation>The reasons for the target error.</documentation>
      </annotation>
      <restriction base="xsd:string">
      <enumeration value="ILLEGAL_CHARS">
      <annotation>
      <documentation>The input string value contains disallowed characters.</documentation>
      </annotation>
      </enumeration>
      <enumeration value="INVALID_FORMAT">
      <annotation>
      <documentation>The input string value is invalid for the associated field.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <simpleType name="StringLengthError.Reason">
      <restriction base="xsd:string">
      <enumeration value="UNKNOWN">
      <annotation>
      <documentation>The value returned if the actual value is not exposed by the requested API version.</documentation>
      </annotation>
      </enumeration>
      </restriction>
      </simpleType>
      <element name="createCustomFieldOptions">
      <annotation>
      <documentation>Creates new {@link CustomFieldOption} objects. <p>The following fields are required: <ul> <li>{@link CustomFieldOption#displayName} <li>{@link CustomFieldOption#customFieldId} </ul></documentation>
      </annotation>
      </element>
      <element name="ApiExceptionFault" type="tns:ApiException">
      <annotation>
      <documentation>A fault element of type ApiException.</documentation>
      </annotation>
      </element>
      <element name="createCustomFields">
      <annotation>
      <documentation>Creates new {@link CustomField} objects. <p>The following fields are required: <ul> <li>{@link CustomField#name} <li>{@link CustomField#entityType} <li>{@link CustomField#dataType} <li>{@link CustomField#visibility} </ul></documentation>
      </annotation>
      </element>
      <element name="getCustomFieldOption">
      <annotation>
      <documentation>Returns the {@link CustomFieldOption} uniquely identified by the given ID.</documentation>
      </annotation>
      </element>
      <element name="getCustomFieldsByStatement">
      <annotation>
      <documentation>Gets a {@link CustomFieldPage} of {@link CustomField} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering: <table> <tr> <th scope="col">PQL Property</th> <th scope="col">Object Property</th> </tr> <tr> <td>{@code id}</td> <td>{@link CustomField#id}</td> </tr> <tr> <td>{@code entityType}</td> <td>{@link CustomField#entityType}</td> </tr> <tr> <td>{@code name}</td> <td>{@link CustomField#name}</td> </tr> <tr> <td>{@code isActive}</td> <td>{@link CustomField#isActive}</td> </tr> <tr> <td>{@code visibility}</td> <td>{@link CustomField#visibility}</td> </tr> </table></documentation>
      </annotation>
      </element>
      </schema>
      </wsdl:types>
      <wsdl:portType name="CustomFieldServiceInterface">
      <wsdl:documentation>Provides methods for the creation and management of {@link CustomField} objects.</wsdl:documentation>
      <wsdl:operation name="createCustomFieldOptions">
      <wsdl:documentation>Creates new {@link CustomFieldOption} objects. <p>The following fields are required: <ul> <li>{@link CustomFieldOption#displayName} <li>{@link CustomFieldOption#customFieldId} </ul></wsdl:documentation>
      </wsdl:operation>
      <wsdl:operation name="createCustomFields">
      <wsdl:documentation>Creates new {@link CustomField} objects. <p>The following fields are required: <ul> <li>{@link CustomField#name} <li>{@link CustomField#entityType} <li>{@link CustomField#dataType} <li>{@link CustomField#visibility} </ul></wsdl:documentation>
      </wsdl:operation>
      <wsdl:operation name="getCustomFieldsByStatement">
      <wsdl:documentation>Gets a {@link CustomFieldPage} of {@link CustomField} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering: <table> <tr> <th scope="col">PQL Property</th> <th scope="col">Object Property</th> </tr> <tr> <td>{@code id}</td> <td>{@link CustomField#id}</td> </tr> <tr> <td>{@code entityType}</td> <td>{@link CustomField#entityType}</td> </tr> <tr> <td>{@code name}</td> <td>{@link CustomField#name}</td> </tr> <tr> <td>{@code isActive}</td> <td>{@link CustomField#isActive}</td> </tr> <tr> <td>{@code visibility}</td> <td>{@link CustomField#visibility}</td> </tr> </table></wsdl:documentation>
      </wsdl:operation>
      </wsdl:portType>
      <wsdl:binding name="CustomFieldServiceSoapBinding" type="tns:CustomFieldServiceInterface"></wsdl:binding>
      </wsdl:definitions>

      About wsdl-viewer.xsl

      This document was generated by SAXON 9.1.0.8 from Saxonica XSLT engine. The engine processed the WSDL in XSLT 2.0 compliant mode.
      This page has been generated bywsdl-viewer.xsl, version 3.1.02
      Author: tomi vanek
      Download athttp://tomi.vanek.sk/xml/wsdl-viewer.xsl.

      The transformation was inspired by the article
      Uche Ogbuji: WSDL processing with XSLT