REST Resource: projects.locations.collections.dataStores.siteSearchEngine.targetSites

Resource: TargetSite

A target site for the SiteSearchEngine.

JSON representation
{
  "name": string,
  "providedUriPattern": string,
  "type": enum (Type),
  "exactMatch": boolean,
  "generatedUriPattern": string,
  "rootDomainUri": string,
  "siteVerificationInfo": {
    object (SiteVerificationInfo)
  },
  "indexingStatus": enum (IndexingStatus),
  "updateTime": string,
  "failureReason": {
    object (FailureReason)
  }
}
Fields
name

string

Output only. The fully qualified resource name of the target site. projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/siteSearchEngine/targetSites/{targetSite} The target_site_id is system-generated.

providedUriPattern

string

Required. Input only. The user provided URI pattern from which the generatedUriPattern is generated.

type

enum (Type)

The type of the target site, e.g., whether the site is to be included or excluded.

exactMatch

boolean

Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the providedUriPattern. If set to true, an uri_pattern is generated to try to be an exact match of the providedUriPattern or just the specific page if the providedUriPattern is a specific one. providedUriPattern is always normalized to generate the URI pattern to be used by the search engine.

generatedUriPattern

string

Output only. This is system-generated based on the providedUriPattern.

rootDomainUri

string

Output only. Root domain of the providedUriPattern.

siteVerificationInfo

object (SiteVerificationInfo)

Output only. Site ownership and validity verification status.

indexingStatus

enum (IndexingStatus)

Output only. Indexing status.

updateTime

string (Timestamp format)

Output only. The target site's last updated time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

failureReason

object (FailureReason)

Output only. Failure reason.

Type

Possible target site types.

Enums
TYPE_UNSPECIFIED This value is unused. In this case, server behavior defaults to Type.INCLUDE.
INCLUDE Include the target site.
EXCLUDE Exclude the target site.

SiteVerificationInfo

Verification information for target sites in advanced site search.

JSON representation
{
  "siteVerificationState": enum (SiteVerificationState),
  "verifyTime": string
}
Fields
siteVerificationState

enum (SiteVerificationState)

Site verification state indicating the ownership and validity.

verifyTime

string (Timestamp format)

Latest site verification time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

SiteVerificationState

Site verification state.

Enums
SITE_VERIFICATION_STATE_UNSPECIFIED Defaults to VERIFIED.
VERIFIED Site ownership verified.
UNVERIFIED Site ownership pending verification or verification failed.
EXEMPTED Site exempt from verification, e.g., a public website that opens to all.

IndexingStatus

Target site indexing status enumeration.

Enums
INDEXING_STATUS_UNSPECIFIED Defaults to SUCCEEDED.
PENDING The target site is in the update queue and will be picked up by indexing pipeline.
FAILED The target site fails to be indexed.
SUCCEEDED The target site has been indexed.
DELETING The previously indexed target site has been marked to be deleted. This is a transitioning state which will resulted in either: 1. target site deleted if unindexing is successful; 2. state reverts to SUCCEEDED if the unindexing fails.

FailureReason

Site search indexing failure reasons.

JSON representation
{

  // Union field failure can be only one of the following:
  "quotaFailure": {
    object (QuotaFailure)
  }
  // End of list of possible types for union field failure.
}
Fields
Union field failure. Failure reason. failure can be only one of the following:
quotaFailure

object (QuotaFailure)

Failed due to insufficient quota.

QuotaFailure

Failed due to insufficient quota.

JSON representation
{
  "totalRequiredQuota": string
}
Fields
totalRequiredQuota

string (int64 format)

This number is an estimation on how much total quota this project needs to successfully complete indexing.

Methods

batchCreate

Creates TargetSite in a batch.

create

Creates a TargetSite.

delete

Deletes a TargetSite.

get

Gets a TargetSite.

list

Gets a list of TargetSites.

patch

Updates a TargetSite.