Class RecaptchaEnterpriseServiceClient (2.32.0)

Service to determine the likelihood an event is legitimate.

Equality

Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection> objects compare equal. Objects that compare equal share the same underlying resources.

Performance

Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.

Thread Safety

Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.

Constructors

RecaptchaEnterpriseServiceClient(RecaptchaEnterpriseServiceClient const &)

Copy and move support

Parameter
Name	Description
	`RecaptchaEnterpriseServiceClient const &`

RecaptchaEnterpriseServiceClient(RecaptchaEnterpriseServiceClient &&)

Copy and move support

Parameter
Name	Description
	`RecaptchaEnterpriseServiceClient &&`

RecaptchaEnterpriseServiceClient(std::shared_ptr< RecaptchaEnterpriseServiceConnection >, Options)

Parameters
Name	Description
`connection`	`std::shared_ptr< RecaptchaEnterpriseServiceConnection >`
`opts`	`Options`

Operators

operator=(RecaptchaEnterpriseServiceClient const &)

Copy and move support

Parameter
Name	Description
	`RecaptchaEnterpriseServiceClient const &`

Returns
Type	Description
`RecaptchaEnterpriseServiceClient &`

operator=(RecaptchaEnterpriseServiceClient &&)

Copy and move support

Parameter
Name	Description
	`RecaptchaEnterpriseServiceClient &&`

Returns
Type	Description
`RecaptchaEnterpriseServiceClient &`

Functions

CreateAssessment(std::string const &, google::cloud::recaptchaenterprise::v1::Assessment const &, Options)

Creates an Assessment of the likelihood an event is legitimate.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project in which the assessment is created, in the format `projects/{project}`.
`assessment`	`google::cloud::recaptchaenterprise::v1::Assessment const &` Required. The assessment details.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Assessment >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Assessment) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

CreateAssessment(google::cloud::recaptchaenterprise::v1::CreateAssessmentRequest const &, Options)

Creates an Assessment of the likelihood an event is legitimate.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::CreateAssessmentRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.CreateAssessmentRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Assessment >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Assessment) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

AnnotateAssessment(std::string const &, google::cloud::recaptchaenterprise::v1::AnnotateAssessmentRequest::Annotation, Options)

Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fraudulent.

Parameters
Name	Description
`name`	`std::string const &` Required. The resource name of the Assessment, in the format `projects/{project}/assessments/{assessment}`.
`annotation`	`google::cloud::recaptchaenterprise::v1::AnnotateAssessmentRequest::Annotation` Optional. The annotation that is assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::AnnotateAssessmentResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.AnnotateAssessmentResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

AnnotateAssessment(google::cloud::recaptchaenterprise::v1::AnnotateAssessmentRequest const &, Options)

Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fraudulent.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::AnnotateAssessmentRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.AnnotateAssessmentRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::AnnotateAssessmentResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.AnnotateAssessmentResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

CreateKey(std::string const &, google::cloud::recaptchaenterprise::v1::Key const &, Options)

Creates a new reCAPTCHA Enterprise key.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project in which the key is created, in the format `projects/{project}`.
`key`	`google::cloud::recaptchaenterprise::v1::Key const &` Required. Information to create a reCAPTCHA Enterprise key.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

CreateKey(google::cloud::recaptchaenterprise::v1::CreateKeyRequest const &, Options)

Creates a new reCAPTCHA Enterprise key.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::CreateKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.CreateKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

ListKeys(std::string const &, Options)

Returns the list of all keys that belong to a project.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project that contains the keys that is listed, in the format `projects/{project}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::Key >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.Key, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListKeys(google::cloud::recaptchaenterprise::v1::ListKeysRequest, Options)

Returns the list of all keys that belong to a project.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ListKeysRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ListKeysRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::Key >

RetrieveLegacySecretKey(std::string const &, Options)

Returns the secret key related to the specified public key.

You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.

Parameters
Name	Description
`key`	`std::string const &` Required. The public key name linked to the requested secret key in the format `projects/{project}/keys/{key}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::RetrieveLegacySecretKeyResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.RetrieveLegacySecretKeyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

RetrieveLegacySecretKey(google::cloud::recaptchaenterprise::v1::RetrieveLegacySecretKeyRequest const &, Options)

Returns the secret key related to the specified public key.

You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::RetrieveLegacySecretKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.RetrieveLegacySecretKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::RetrieveLegacySecretKeyResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.RetrieveLegacySecretKeyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

GetKey(std::string const &, Options)

Returns the specified key.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the requested key, in the format `projects/{project}/keys/{key}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

GetKey(google::cloud::recaptchaenterprise::v1::GetKeyRequest const &, Options)

Returns the specified key.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::GetKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.GetKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

UpdateKey(google::cloud::recaptchaenterprise::v1::Key const &, google::protobuf::FieldMask const &, Options)

Updates the specified key.

Parameters
Name	Description
`key`	`google::cloud::recaptchaenterprise::v1::Key const &` Required. The key to update.
`update_mask`	`google::protobuf::FieldMask const &` Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields are updated.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

UpdateKey(google::cloud::recaptchaenterprise::v1::UpdateKeyRequest const &, Options)

Updates the specified key.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::UpdateKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.UpdateKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

DeleteKey(std::string const &, Options)

Deletes the specified key.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the key to be deleted, in the format `projects/{project}/keys/{key}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`Status`	a `Status` object. If the request failed, the status contains the details of the failure.

DeleteKey(google::cloud::recaptchaenterprise::v1::DeleteKeyRequest const &, Options)

Deletes the specified key.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::DeleteKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.DeleteKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`Status`	a `Status` object. If the request failed, the status contains the details of the failure.

MigrateKey(google::cloud::recaptchaenterprise::v1::MigrateKeyRequest const &, Options)

Migrates an existing key from reCAPTCHA to reCAPTCHA Enterprise.

Once a key is migrated, it can be used from either product. SiteVerify requests are billed as CreateAssessment calls. You must be authenticated as one of the current owners of the reCAPTCHA Key, and your user must have the reCAPTCHA Enterprise Admin IAM role in the destination project.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::MigrateKeyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.MigrateKeyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Key >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Key) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

AddIpOverride(std::string const &, google::cloud::recaptchaenterprise::v1::IpOverrideData const &, Options)

Adds an IP override to a key.

The following restrictions hold:

The maximum number of IP overrides per key is 100.
For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the key to which the IP override is added, in the format `projects/{project}/keys/{key}`.
`ip_override_data`	`google::cloud::recaptchaenterprise::v1::IpOverrideData const &` Required. IP override added to the key.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::AddIpOverrideResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.AddIpOverrideResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

AddIpOverride(google::cloud::recaptchaenterprise::v1::AddIpOverrideRequest const &, Options)

Adds an IP override to a key.

The following restrictions hold:

The maximum number of IP overrides per key is 100.
For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::AddIpOverrideRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.AddIpOverrideRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::AddIpOverrideResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.AddIpOverrideResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

RemoveIpOverride(std::string const &, google::cloud::recaptchaenterprise::v1::IpOverrideData const &, Options)

Removes an IP override from a key.

The following restrictions hold:

If the IP isn't found in an existing IP override, a NOT_FOUND error is returned.
If the IP is found in an existing IP override, but the override type does not match, a NOT_FOUND error is returned.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the key from which the IP override is removed, in the format `projects/{project}/keys/{key}`.
`ip_override_data`	`google::cloud::recaptchaenterprise::v1::IpOverrideData const &` Required. IP override to be removed from the key.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::RemoveIpOverrideResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.RemoveIpOverrideResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

RemoveIpOverride(google::cloud::recaptchaenterprise::v1::RemoveIpOverrideRequest const &, Options)

Removes an IP override from a key.

The following restrictions hold:

If the IP isn't found in an existing IP override, a NOT_FOUND error is returned.
If the IP is found in an existing IP override, but the override type does not match, a NOT_FOUND error is returned.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::RemoveIpOverrideRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.RemoveIpOverrideRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::RemoveIpOverrideResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.RemoveIpOverrideResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

ListIpOverrides(std::string const &, Options)

Lists all IP overrides for a key.

Parameters
Name	Description
`parent`	`std::string const &` Required. The parent key for which the IP overrides are listed, in the format `projects/{project}/keys/{key}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::IpOverrideData >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.IpOverrideData, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListIpOverrides(google::cloud::recaptchaenterprise::v1::ListIpOverridesRequest, Options)

Lists all IP overrides for a key.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ListIpOverridesRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ListIpOverridesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::IpOverrideData >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.IpOverrideData, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetMetrics(std::string const &, Options)

Get some aggregated metrics for a Key.

This data can be used to build dashboards.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the requested metrics, in the format `projects/{project}/keys/{key}/metrics`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Metrics >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Metrics) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

GetMetrics(google::cloud::recaptchaenterprise::v1::GetMetricsRequest const &, Options)

Get some aggregated metrics for a Key.

This data can be used to build dashboards.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::GetMetricsRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.GetMetricsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::Metrics >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.Metrics) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

CreateFirewallPolicy(std::string const &, google::cloud::recaptchaenterprise::v1::FirewallPolicy const &, Options)

Creates a new FirewallPolicy, specifying conditions at which reCAPTCHA Enterprise actions can be executed.

A project may have a maximum of 1000 policies.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project this policy applies to, in the format `projects/{project}`.
`firewall_policy`	`google::cloud::recaptchaenterprise::v1::FirewallPolicy const &` Required. Information to create the policy.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

CreateFirewallPolicy(google::cloud::recaptchaenterprise::v1::CreateFirewallPolicyRequest const &, Options)

Creates a new FirewallPolicy, specifying conditions at which reCAPTCHA Enterprise actions can be executed.

A project may have a maximum of 1000 policies.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::CreateFirewallPolicyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.CreateFirewallPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

ListFirewallPolicies(std::string const &, Options)

Returns the list of all firewall policies that belong to a project.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project to list the policies for, in the format `projects/{project}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::FirewallPolicy >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.FirewallPolicy, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListFirewallPolicies(google::cloud::recaptchaenterprise::v1::ListFirewallPoliciesRequest, Options)

Returns the list of all firewall policies that belong to a project.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ListFirewallPoliciesRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ListFirewallPoliciesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::FirewallPolicy >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.FirewallPolicy, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetFirewallPolicy(std::string const &, Options)

Returns the specified firewall policy.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the requested policy, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

GetFirewallPolicy(google::cloud::recaptchaenterprise::v1::GetFirewallPolicyRequest const &, Options)

Returns the specified firewall policy.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::GetFirewallPolicyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.GetFirewallPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

UpdateFirewallPolicy(google::cloud::recaptchaenterprise::v1::FirewallPolicy const &, google::protobuf::FieldMask const &, Options)

Updates the specified firewall policy.

Parameters
Name	Description
`firewall_policy`	`google::cloud::recaptchaenterprise::v1::FirewallPolicy const &` Required. The policy to update.
`update_mask`	`google::protobuf::FieldMask const &` Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields are updated.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

UpdateFirewallPolicy(google::cloud::recaptchaenterprise::v1::UpdateFirewallPolicyRequest const &, Options)

Updates the specified firewall policy.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::UpdateFirewallPolicyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.UpdateFirewallPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::FirewallPolicy >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.FirewallPolicy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

DeleteFirewallPolicy(std::string const &, Options)

Deletes the specified firewall policy.

Parameters
Name	Description
`name`	`std::string const &` Required. The name of the policy to be deleted, in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`Status`	a `Status` object. If the request failed, the status contains the details of the failure.

DeleteFirewallPolicy(google::cloud::recaptchaenterprise::v1::DeleteFirewallPolicyRequest const &, Options)

Deletes the specified firewall policy.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::DeleteFirewallPolicyRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.DeleteFirewallPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`Status`	a `Status` object. If the request failed, the status contains the details of the failure.

ReorderFirewallPolicies(std::string const &, std::vector< std::string > const &, Options)

Reorders all firewall policies.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project to list the policies for, in the format `projects/{project}`.
`names`	`std::vector< std::string > const &` Required. A list containing all policy names, in the new order. Each name is in the format `projects/{project}/firewallpolicies/{firewallpolicy}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::ReorderFirewallPoliciesResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.ReorderFirewallPoliciesResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

ReorderFirewallPolicies(google::cloud::recaptchaenterprise::v1::ReorderFirewallPoliciesRequest const &, Options)

Reorders all firewall policies.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ReorderFirewallPoliciesRequest const &` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ReorderFirewallPoliciesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
`StatusOr< google::cloud::recaptchaenterprise::v1::ReorderFirewallPoliciesResponse >`	the result of the RPC. The response message type (google.cloud.recaptchaenterprise.v1.ReorderFirewallPoliciesResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the `StatusOr` contains the error details.

ListRelatedAccountGroups(std::string const &, Options)

List groups of related accounts.

Parameters
Name	Description
`parent`	`std::string const &` Required. The name of the project to list related account groups from, in the format `projects/{project}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroup >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroup, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListRelatedAccountGroups(google::cloud::recaptchaenterprise::v1::ListRelatedAccountGroupsRequest, Options)

List groups of related accounts.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ListRelatedAccountGroupsRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ListRelatedAccountGroupsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroup >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroup, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListRelatedAccountGroupMemberships(std::string const &, Options)

Get memberships in a group of related accounts.

Parameters
Name	Description
`parent`	`std::string const &` Required. The resource name for the related account group in the format `projects/{project}/relatedaccountgroups/{relatedaccountgroup}`.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroupMembership >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroupMembership, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListRelatedAccountGroupMemberships(google::cloud::recaptchaenterprise::v1::ListRelatedAccountGroupMembershipsRequest, Options)

Get memberships in a group of related accounts.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::ListRelatedAccountGroupMembershipsRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.ListRelatedAccountGroupMembershipsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroupMembership >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroupMembership, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

SearchRelatedAccountGroupMemberships(std::string const &, std::string const &, Options)

Search group memberships related to a given account.

Parameters
Name	Description
`project`	`std::string const &` Required. The name of the project to search related account group memberships from. Specify the project name in the following format: `projects/{project}`.
`hashed_account_id`	`std::string const &` Optional. Deprecated: use `account_id` instead. The unique stable hashed account identifier used to search connections. The identifier should correspond to a `hashed_account_id` provided in a previous `CreateAssessment` or `AnnotateAssessment` call. Either hashed_account_id or account_id must be set, but not both.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroupMembership >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroupMembership, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

SearchRelatedAccountGroupMemberships(google::cloud::recaptchaenterprise::v1::SearchRelatedAccountGroupMembershipsRequest, Options)

Search group memberships related to a given account.

Parameters
Name	Description
`request`	`google::cloud::recaptchaenterprise::v1::SearchRelatedAccountGroupMembershipsRequest` Unary RPCs, such as the one wrapped by this function, receive a single `request` proto message which includes all the inputs for the RPC. In this case, the proto message is a google.cloud.recaptchaenterprise.v1.SearchRelatedAccountGroupMembershipsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
`opts`	`Options` Optional. Override the class-level options, such as retry and backoff policies.

Returns

Type Description

StreamRange< google::cloud::recaptchaenterprise::v1::RelatedAccountGroupMembership >

a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.cloud.recaptchaenterprise.v1.RelatedAccountGroupMembership, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.