Class ChallengeRule.Builder (3.96.0)

public static final class ChallengeRule.Builder extends GeneratedMessage.Builder<ChallengeRule.Builder> implements ChallengeRuleOrBuilder

A rule to configure the behavior of reCAPTCHA for conditionally presenting a challenge.

Protobuf type google.cloud.recaptchaenterprise.v1.ChallengeRule

Static Methods

getDescriptor()

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

Methods

build()

public ChallengeRule build()
Returns
Type Description
ChallengeRule

buildPartial()

public ChallengeRule buildPartial()
Returns
Type Description
ChallengeRule

clear()

public ChallengeRule.Builder clear()
Returns
Type Description
ChallengeRule.Builder
Overrides

clearChallenge()

public ChallengeRule.Builder clearChallenge()

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Returns
Type Description
ChallengeRule.Builder

clearCondition()

public ChallengeRule.Builder clearCondition()

Optional. A CEL condition that must be met for this rule to apply. If unspecified, the rule applies unconditionally. The following fields can be referenced in the condition:

  • score
  • user_ip_address
  • user_asn
  • user_agent
  • verified_bots.name
  • verified_bots.bot_type

    Examples:

  • score < 0.5
  • user_ip_address == "123.45.67.89"
  • user_agent.contains("Chrome")
  • score < 0.5 && user_ip_address == "123.45.67.89"

string condition = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ChallengeRule.Builder

This builder for chaining.

clearNoChallenge()

public ChallengeRule.Builder clearNoChallenge()

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Returns
Type Description
ChallengeRule.Builder

clearOutcome()

public ChallengeRule.Builder clearOutcome()
Returns
Type Description
ChallengeRule.Builder

getChallenge()

public ChallengeRule.ChallengeOutcome getChallenge()

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Returns
Type Description
ChallengeRule.ChallengeOutcome

The challenge.

getChallengeBuilder()

public ChallengeRule.ChallengeOutcome.Builder getChallengeBuilder()

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Returns
Type Description
ChallengeRule.ChallengeOutcome.Builder

getChallengeOrBuilder()

public ChallengeRule.ChallengeOutcomeOrBuilder getChallengeOrBuilder()

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Returns
Type Description
ChallengeRule.ChallengeOutcomeOrBuilder

getCondition()

public String getCondition()

Optional. A CEL condition that must be met for this rule to apply. If unspecified, the rule applies unconditionally. The following fields can be referenced in the condition:

  • score
  • user_ip_address
  • user_asn
  • user_agent
  • verified_bots.name
  • verified_bots.bot_type

    Examples:

  • score < 0.5
  • user_ip_address == "123.45.67.89"
  • user_agent.contains("Chrome")
  • score < 0.5 && user_ip_address == "123.45.67.89"

string condition = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
String

The condition.

getConditionBytes()

public ByteString getConditionBytes()

Optional. A CEL condition that must be met for this rule to apply. If unspecified, the rule applies unconditionally. The following fields can be referenced in the condition:

  • score
  • user_ip_address
  • user_asn
  • user_agent
  • verified_bots.name
  • verified_bots.bot_type

    Examples:

  • score < 0.5
  • user_ip_address == "123.45.67.89"
  • user_agent.contains("Chrome")
  • score < 0.5 && user_ip_address == "123.45.67.89"

string condition = 1 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ByteString

The bytes for condition.

getDefaultInstanceForType()

public ChallengeRule getDefaultInstanceForType()
Returns
Type Description
ChallengeRule

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getNoChallenge()

public ChallengeRule.NoChallengeOutcome getNoChallenge()

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Returns
Type Description
ChallengeRule.NoChallengeOutcome

The noChallenge.

getNoChallengeBuilder()

public ChallengeRule.NoChallengeOutcome.Builder getNoChallengeBuilder()

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Returns
Type Description
ChallengeRule.NoChallengeOutcome.Builder

getNoChallengeOrBuilder()

public ChallengeRule.NoChallengeOutcomeOrBuilder getNoChallengeOrBuilder()

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Returns
Type Description
ChallengeRule.NoChallengeOutcomeOrBuilder

getOutcomeCase()

public ChallengeRule.OutcomeCase getOutcomeCase()
Returns
Type Description
ChallengeRule.OutcomeCase

hasChallenge()

public boolean hasChallenge()

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Returns
Type Description
boolean

Whether the challenge field is set.

hasNoChallenge()

public boolean hasNoChallenge()

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Returns
Type Description
boolean

Whether the noChallenge field is set.

internalGetFieldAccessorTable()

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

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeChallenge(ChallengeRule.ChallengeOutcome value)

public ChallengeRule.Builder mergeChallenge(ChallengeRule.ChallengeOutcome value)

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Parameter
Name Description
value ChallengeRule.ChallengeOutcome
Returns
Type Description
ChallengeRule.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public ChallengeRule.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
ChallengeRule.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public ChallengeRule.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
ChallengeRule.Builder
Overrides

mergeFrom(ChallengeRule other)

public ChallengeRule.Builder mergeFrom(ChallengeRule other)
Parameter
Name Description
other ChallengeRule
Returns
Type Description
ChallengeRule.Builder

mergeNoChallenge(ChallengeRule.NoChallengeOutcome value)

public ChallengeRule.Builder mergeNoChallenge(ChallengeRule.NoChallengeOutcome value)

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Parameter
Name Description
value ChallengeRule.NoChallengeOutcome
Returns
Type Description
ChallengeRule.Builder

setChallenge(ChallengeRule.ChallengeOutcome value)

public ChallengeRule.Builder setChallenge(ChallengeRule.ChallengeOutcome value)

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Parameter
Name Description
value ChallengeRule.ChallengeOutcome
Returns
Type Description
ChallengeRule.Builder

setChallenge(ChallengeRule.ChallengeOutcome.Builder builderForValue)

public ChallengeRule.Builder setChallenge(ChallengeRule.ChallengeOutcome.Builder builderForValue)

Present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.ChallengeOutcome challenge = 3;

Parameter
Name Description
builderForValue ChallengeRule.ChallengeOutcome.Builder
Returns
Type Description
ChallengeRule.Builder

setCondition(String value)

public ChallengeRule.Builder setCondition(String value)

Optional. A CEL condition that must be met for this rule to apply. If unspecified, the rule applies unconditionally. The following fields can be referenced in the condition:

  • score
  • user_ip_address
  • user_asn
  • user_agent
  • verified_bots.name
  • verified_bots.bot_type

    Examples:

  • score < 0.5
  • user_ip_address == "123.45.67.89"
  • user_agent.contains("Chrome")
  • score < 0.5 && user_ip_address == "123.45.67.89"

string condition = 1 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The condition to set.

Returns
Type Description
ChallengeRule.Builder

This builder for chaining.

setConditionBytes(ByteString value)

public ChallengeRule.Builder setConditionBytes(ByteString value)

Optional. A CEL condition that must be met for this rule to apply. If unspecified, the rule applies unconditionally. The following fields can be referenced in the condition:

  • score
  • user_ip_address
  • user_asn
  • user_agent
  • verified_bots.name
  • verified_bots.bot_type

    Examples:

  • score < 0.5
  • user_ip_address == "123.45.67.89"
  • user_agent.contains("Chrome")
  • score < 0.5 && user_ip_address == "123.45.67.89"

string condition = 1 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes for condition to set.

Returns
Type Description
ChallengeRule.Builder

This builder for chaining.

setNoChallenge(ChallengeRule.NoChallengeOutcome value)

public ChallengeRule.Builder setNoChallenge(ChallengeRule.NoChallengeOutcome value)

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Parameter
Name Description
value ChallengeRule.NoChallengeOutcome
Returns
Type Description
ChallengeRule.Builder

setNoChallenge(ChallengeRule.NoChallengeOutcome.Builder builderForValue)

public ChallengeRule.Builder setNoChallenge(ChallengeRule.NoChallengeOutcome.Builder builderForValue)

Do not present a challenge to the user.

.google.cloud.recaptchaenterprise.v1.ChallengeRule.NoChallengeOutcome no_challenge = 2;

Parameter
Name Description
builderForValue ChallengeRule.NoChallengeOutcome.Builder
Returns
Type Description
ChallengeRule.Builder