Class Page (0.54.0)

public final class Page extends GeneratedMessageV3 implements PageOrBuilder

A Dialogflow CX conversation (session) can be described and visualized as a state machine. The states of a CX session are represented by pages.

For each flow, you define many pages, where your combined pages can handle a complete conversation on the topics the flow is designed for. At any given moment, exactly one page is the current page, the current page is considered active, and the flow associated with that page is considered active. Every flow has a special start page. When a flow initially becomes active, the start page page becomes the current page. For each conversational turn, the current page will either stay the same or transition to another page.

You configure each page to collect information from the end-user that is relevant for the conversational state represented by the page.

For more information, see the Page guide.

Protobuf type google.cloud.dialogflow.cx.v3.Page

Implements

PageOrBuilder

Static Fields

ADVANCED_SETTINGS_FIELD_NUMBER

public static final int ADVANCED_SETTINGS_FIELD_NUMBER
Field Value
Type Description
int

DESCRIPTION_FIELD_NUMBER

public static final int DESCRIPTION_FIELD_NUMBER
Field Value
Type Description
int

DISPLAY_NAME_FIELD_NUMBER

public static final int DISPLAY_NAME_FIELD_NUMBER
Field Value
Type Description
int

ENTRY_FULFILLMENT_FIELD_NUMBER

public static final int ENTRY_FULFILLMENT_FIELD_NUMBER
Field Value
Type Description
int

EVENT_HANDLERS_FIELD_NUMBER

public static final int EVENT_HANDLERS_FIELD_NUMBER
Field Value
Type Description
int

FORM_FIELD_NUMBER

public static final int FORM_FIELD_NUMBER
Field Value
Type Description
int

KNOWLEDGE_CONNECTOR_SETTINGS_FIELD_NUMBER

public static final int KNOWLEDGE_CONNECTOR_SETTINGS_FIELD_NUMBER
Field Value
Type Description
int

NAME_FIELD_NUMBER

public static final int NAME_FIELD_NUMBER
Field Value
Type Description
int

TRANSITION_ROUTES_FIELD_NUMBER

public static final int TRANSITION_ROUTES_FIELD_NUMBER
Field Value
Type Description
int

TRANSITION_ROUTE_GROUPS_FIELD_NUMBER

public static final int TRANSITION_ROUTE_GROUPS_FIELD_NUMBER
Field Value
Type Description
int

Static Methods

getDefaultInstance()

public static Page getDefaultInstance()
Returns
Type Description
Page

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

newBuilder()

public static Page.Builder newBuilder()
Returns
Type Description
Page.Builder

newBuilder(Page prototype)

public static Page.Builder newBuilder(Page prototype)
Parameter
Name Description
prototype Page
Returns
Type Description
Page.Builder

parseDelimitedFrom(InputStream input)

public static Page parseDelimitedFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Page parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseFrom(byte[] data)

public static Page parseFrom(byte[] data)
Parameter
Name Description
data byte[]
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Page parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data byte[]
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Page parseFrom(ByteString data)
Parameter
Name Description
data ByteString
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Page parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteString
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Page parseFrom(CodedInputStream input)
Parameter
Name Description
input CodedInputStream
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Page parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseFrom(InputStream input)

public static Page parseFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Page parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
IOException

parseFrom(ByteBuffer data)

public static Page parseFrom(ByteBuffer data)
Parameter
Name Description
data ByteBuffer
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Page parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteBuffer
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Page
Exceptions
Type Description
InvalidProtocolBufferException

parser()

public static Parser<Page> parser()
Returns
Type Description
Parser<Page>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
boolean
Overrides

getAdvancedSettings()

public AdvancedSettings getAdvancedSettings()

Hierarchical advanced settings for this page. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3.AdvancedSettings advanced_settings = 13;

Returns
Type Description
AdvancedSettings

The advancedSettings.

getAdvancedSettingsOrBuilder()

public AdvancedSettingsOrBuilder getAdvancedSettingsOrBuilder()

Hierarchical advanced settings for this page. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3.AdvancedSettings advanced_settings = 13;

Returns
Type Description
AdvancedSettingsOrBuilder

getDefaultInstanceForType()

public Page getDefaultInstanceForType()
Returns
Type Description
Page

getDescription()

public String getDescription()

The description of the page. The maximum length is 500 characters.

string description = 19;

Returns
Type Description
String

The description.

getDescriptionBytes()

public ByteString getDescriptionBytes()

The description of the page. The maximum length is 500 characters.

string description = 19;

Returns
Type Description
ByteString

The bytes for description.

getDisplayName()

public String getDisplayName()

Required. The human-readable name of the page, unique within the flow.

string display_name = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
String

The displayName.

getDisplayNameBytes()

public ByteString getDisplayNameBytes()

Required. The human-readable name of the page, unique within the flow.

string display_name = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
ByteString

The bytes for displayName.

getEntryFulfillment()

public Fulfillment getEntryFulfillment()

The fulfillment to call when the session is entering the page.

.google.cloud.dialogflow.cx.v3.Fulfillment entry_fulfillment = 7;

Returns
Type Description
Fulfillment

The entryFulfillment.

getEntryFulfillmentOrBuilder()

public FulfillmentOrBuilder getEntryFulfillmentOrBuilder()

The fulfillment to call when the session is entering the page.

.google.cloud.dialogflow.cx.v3.Fulfillment entry_fulfillment = 7;

Returns
Type Description
FulfillmentOrBuilder

getEventHandlers(int index)

public EventHandler getEventHandlers(int index)

Handlers associated with the page to handle events such as webhook errors, no match or no input.

repeated .google.cloud.dialogflow.cx.v3.EventHandler event_handlers = 10;

Parameter
Name Description
index int
Returns
Type Description
EventHandler

getEventHandlersCount()

public int getEventHandlersCount()

Handlers associated with the page to handle events such as webhook errors, no match or no input.

repeated .google.cloud.dialogflow.cx.v3.EventHandler event_handlers = 10;

Returns
Type Description
int

getEventHandlersList()

public List<EventHandler> getEventHandlersList()

Handlers associated with the page to handle events such as webhook errors, no match or no input.

repeated .google.cloud.dialogflow.cx.v3.EventHandler event_handlers = 10;

Returns
Type Description
List<EventHandler>

getEventHandlersOrBuilder(int index)

public EventHandlerOrBuilder getEventHandlersOrBuilder(int index)

Handlers associated with the page to handle events such as webhook errors, no match or no input.

repeated .google.cloud.dialogflow.cx.v3.EventHandler event_handlers = 10;

Parameter
Name Description
index int
Returns
Type Description
EventHandlerOrBuilder

getEventHandlersOrBuilderList()

public List<? extends EventHandlerOrBuilder> getEventHandlersOrBuilderList()

Handlers associated with the page to handle events such as webhook errors, no match or no input.

repeated .google.cloud.dialogflow.cx.v3.EventHandler event_handlers = 10;

Returns
Type Description
List<? extends com.google.cloud.dialogflow.cx.v3.EventHandlerOrBuilder>

getForm()

public Form getForm()

The form associated with the page, used for collecting parameters relevant to the page.

.google.cloud.dialogflow.cx.v3.Form form = 4;

Returns
Type Description
Form

The form.

getFormOrBuilder()

public FormOrBuilder getFormOrBuilder()

The form associated with the page, used for collecting parameters relevant to the page.

.google.cloud.dialogflow.cx.v3.Form form = 4;

Returns
Type Description
FormOrBuilder

getKnowledgeConnectorSettings()

public KnowledgeConnectorSettings getKnowledgeConnectorSettings()

Optional. Knowledge connector configuration.

.google.cloud.dialogflow.cx.v3.KnowledgeConnectorSettings knowledge_connector_settings = 18 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
KnowledgeConnectorSettings

The knowledgeConnectorSettings.

getKnowledgeConnectorSettingsOrBuilder()

public KnowledgeConnectorSettingsOrBuilder getKnowledgeConnectorSettingsOrBuilder()

Optional. Knowledge connector configuration.

.google.cloud.dialogflow.cx.v3.KnowledgeConnectorSettings knowledge_connector_settings = 18 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
KnowledgeConnectorSettingsOrBuilder

getName()

public String getName()

The unique identifier of the page. Required for the Pages.UpdatePage method. Pages.CreatePage populates the name automatically. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>.

string name = 1;

Returns
Type Description
String

The name.

getNameBytes()

public ByteString getNameBytes()

The unique identifier of the page. Required for the Pages.UpdatePage method. Pages.CreatePage populates the name automatically. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>.

string name = 1;

Returns
Type Description
ByteString

The bytes for name.

getParserForType()

public Parser<Page> getParserForType()
Returns
Type Description
Parser<Page>
Overrides

getSerializedSize()

public int getSerializedSize()
Returns
Type Description
int
Overrides

getTransitionRouteGroups(int index)

public String getTransitionRouteGroups(int index)

Ordered list of TransitionRouteGroups added to the page. Transition route groups must be unique within a page. If the page links both flow-level transition route groups and agent-level transition route groups, the flow-level ones will have higher priority and will be put before the agent-level ones.

  • If multiple transition routes within a page scope refer to the same intent, then the precedence order is: page's transition route -> page's transition route group -> flow's transition routes.

  • If multiple transition route groups within a page contain the same intent, then the first group in the ordered list takes precedence.

    Format:projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/transitionRouteGroups/<TransitionRouteGroup ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/transitionRouteGroups/<TransitionRouteGroup ID> for agent-level groups.

repeated string transition_route_groups = 11 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
index int

The index of the element to return.

Returns
Type Description
String

The transitionRouteGroups at the given index.

getTransitionRouteGroupsBytes(int index)

public ByteString getTransitionRouteGroupsBytes(int index)

Ordered list of TransitionRouteGroups added to the page. Transition route groups must be unique within a page. If the page links both flow-level transition route groups and agent-level transition route groups, the flow-level ones will have higher priority and will be put before the agent-level ones.

  • If multiple transition routes within a page scope refer to the same intent, then the precedence order is: page's transition route -> page's transition route group -> flow's transition routes.

  • If multiple transition route groups within a page contain the same intent, then the first group in the ordered list takes precedence.

    Format:projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/transitionRouteGroups/<TransitionRouteGroup ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/transitionRouteGroups/<TransitionRouteGroup ID> for agent-level groups.

repeated string transition_route_groups = 11 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
index int

The index of the value to return.

Returns
Type Description
ByteString

The bytes of the transitionRouteGroups at the given index.

getTransitionRouteGroupsCount()

public int getTransitionRouteGroupsCount()

Ordered list of TransitionRouteGroups added to the page. Transition route groups must be unique within a page. If the page links both flow-level transition route groups and agent-level transition route groups, the flow-level ones will have higher priority and will be put before the agent-level ones.

  • If multiple transition routes within a page scope refer to the same intent, then the precedence order is: page's transition route -> page's transition route group -> flow's transition routes.

  • If multiple transition route groups within a page contain the same intent, then the first group in the ordered list takes precedence.

    Format:projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/transitionRouteGroups/<TransitionRouteGroup ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/transitionRouteGroups/<TransitionRouteGroup ID> for agent-level groups.

repeated string transition_route_groups = 11 [(.google.api.resource_reference) = { ... }

Returns
Type Description
int

The count of transitionRouteGroups.

getTransitionRouteGroupsList()

public ProtocolStringList getTransitionRouteGroupsList()

Ordered list of TransitionRouteGroups added to the page. Transition route groups must be unique within a page. If the page links both flow-level transition route groups and agent-level transition route groups, the flow-level ones will have higher priority and will be put before the agent-level ones.

  • If multiple transition routes within a page scope refer to the same intent, then the precedence order is: page's transition route -> page's transition route group -> flow's transition routes.

  • If multiple transition route groups within a page contain the same intent, then the first group in the ordered list takes precedence.

    Format:projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/transitionRouteGroups/<TransitionRouteGroup ID> or projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/transitionRouteGroups/<TransitionRouteGroup ID> for agent-level groups.

repeated string transition_route_groups = 11 [(.google.api.resource_reference) = { ... }

Returns
Type Description
ProtocolStringList

A list containing the transitionRouteGroups.

getTransitionRoutes(int index)

public TransitionRoute getTransitionRoutes(int index)

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

  • TransitionRoutes defined in the page with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in flow with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in the page with only condition specified.
  • TransitionRoutes defined in the transition route groups with only condition specified.

repeated .google.cloud.dialogflow.cx.v3.TransitionRoute transition_routes = 9;

Parameter
Name Description
index int
Returns
Type Description
TransitionRoute

getTransitionRoutesCount()

public int getTransitionRoutesCount()

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

  • TransitionRoutes defined in the page with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in flow with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in the page with only condition specified.
  • TransitionRoutes defined in the transition route groups with only condition specified.

repeated .google.cloud.dialogflow.cx.v3.TransitionRoute transition_routes = 9;

Returns
Type Description
int

getTransitionRoutesList()

public List<TransitionRoute> getTransitionRoutesList()

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

  • TransitionRoutes defined in the page with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in flow with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in the page with only condition specified.
  • TransitionRoutes defined in the transition route groups with only condition specified.

repeated .google.cloud.dialogflow.cx.v3.TransitionRoute transition_routes = 9;

Returns
Type Description
List<TransitionRoute>

getTransitionRoutesOrBuilder(int index)

public TransitionRouteOrBuilder getTransitionRoutesOrBuilder(int index)

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

  • TransitionRoutes defined in the page with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in flow with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in the page with only condition specified.
  • TransitionRoutes defined in the transition route groups with only condition specified.

repeated .google.cloud.dialogflow.cx.v3.TransitionRoute transition_routes = 9;

Parameter
Name Description
index int
Returns
Type Description
TransitionRouteOrBuilder

getTransitionRoutesOrBuilderList()

public List<? extends TransitionRouteOrBuilder> getTransitionRoutesOrBuilderList()

A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow.

When we are in a certain page, the TransitionRoutes are evalauted in the following order:

  • TransitionRoutes defined in the page with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in flow with intent specified.
  • TransitionRoutes defined in the transition route groups with intent specified.
  • TransitionRoutes defined in the page with only condition specified.
  • TransitionRoutes defined in the transition route groups with only condition specified.

repeated .google.cloud.dialogflow.cx.v3.TransitionRoute transition_routes = 9;

Returns
Type Description
List<? extends com.google.cloud.dialogflow.cx.v3.TransitionRouteOrBuilder>

hasAdvancedSettings()

public boolean hasAdvancedSettings()

Hierarchical advanced settings for this page. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3.AdvancedSettings advanced_settings = 13;

Returns
Type Description
boolean

Whether the advancedSettings field is set.

hasEntryFulfillment()

public boolean hasEntryFulfillment()

The fulfillment to call when the session is entering the page.

.google.cloud.dialogflow.cx.v3.Fulfillment entry_fulfillment = 7;

Returns
Type Description
boolean

Whether the entryFulfillment field is set.

hasForm()

public boolean hasForm()

The form associated with the page, used for collecting parameters relevant to the page.

.google.cloud.dialogflow.cx.v3.Form form = 4;

Returns
Type Description
boolean

Whether the form field is set.

hasKnowledgeConnectorSettings()

public boolean hasKnowledgeConnectorSettings()

Optional. Knowledge connector configuration.

.google.cloud.dialogflow.cx.v3.KnowledgeConnectorSettings knowledge_connector_settings = 18 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
boolean

Whether the knowledgeConnectorSettings field is set.

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

newBuilderForType()

public Page.Builder newBuilderForType()
Returns
Type Description
Page.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Page.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Name Description
parent BuilderParent
Returns
Type Description
Page.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Name Description
unused UnusedPrivateParameter
Returns
Type Description
Object
Overrides

toBuilder()

public Page.Builder toBuilder()
Returns
Type Description
Page.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
Name Description
output CodedOutputStream
Overrides
Exceptions
Type Description
IOException