Documentation ¶
Overview ¶
Package safebrowsing provides access to the Safe Browsing API.
See https://developers.google.com/safe-browsing/
Usage example:
import "google.golang.org/api/safebrowsing/v4" ... safebrowsingService, err := safebrowsing.New(oauthHttpClient)
Index ¶
- type Checksum
- type ClientInfo
- type Constraints
- type Empty
- type EncodedFullHashesGetCall
- func (c *EncodedFullHashesGetCall) ClientId(clientId string) *EncodedFullHashesGetCall
- func (c *EncodedFullHashesGetCall) ClientVersion(clientVersion string) *EncodedFullHashesGetCall
- func (c *EncodedFullHashesGetCall) Context(ctx context.Context) *EncodedFullHashesGetCall
- func (c *EncodedFullHashesGetCall) Do(opts ...googleapi.CallOption) (*FindFullHashesResponse, error)
- func (c *EncodedFullHashesGetCall) Fields(s ...googleapi.Field) *EncodedFullHashesGetCall
- func (c *EncodedFullHashesGetCall) Header() http.Header
- func (c *EncodedFullHashesGetCall) IfNoneMatch(entityTag string) *EncodedFullHashesGetCall
- type EncodedFullHashesService
- type EncodedUpdatesGetCall
- func (c *EncodedUpdatesGetCall) ClientId(clientId string) *EncodedUpdatesGetCall
- func (c *EncodedUpdatesGetCall) ClientVersion(clientVersion string) *EncodedUpdatesGetCall
- func (c *EncodedUpdatesGetCall) Context(ctx context.Context) *EncodedUpdatesGetCall
- func (c *EncodedUpdatesGetCall) Do(opts ...googleapi.CallOption) (*FetchThreatListUpdatesResponse, error)
- func (c *EncodedUpdatesGetCall) Fields(s ...googleapi.Field) *EncodedUpdatesGetCall
- func (c *EncodedUpdatesGetCall) Header() http.Header
- func (c *EncodedUpdatesGetCall) IfNoneMatch(entityTag string) *EncodedUpdatesGetCall
- type EncodedUpdatesService
- type FetchThreatListUpdatesRequest
- type FetchThreatListUpdatesResponse
- type FindFullHashesRequest
- type FindFullHashesResponse
- type FindThreatMatchesRequest
- type FindThreatMatchesResponse
- type FullHashesFindCall
- func (c *FullHashesFindCall) Context(ctx context.Context) *FullHashesFindCall
- func (c *FullHashesFindCall) Do(opts ...googleapi.CallOption) (*FindFullHashesResponse, error)
- func (c *FullHashesFindCall) Fields(s ...googleapi.Field) *FullHashesFindCall
- func (c *FullHashesFindCall) Header() http.Header
- type FullHashesService
- type ListThreatListsResponse
- type ListUpdateRequest
- type ListUpdateResponse
- type MetadataEntry
- type RawHashes
- type RawIndices
- type RiceDeltaEncoding
- type Service
- type ThreatEntry
- type ThreatEntryMetadata
- type ThreatEntrySet
- type ThreatHit
- type ThreatHitsCreateCall
- type ThreatHitsService
- type ThreatInfo
- type ThreatListDescriptor
- type ThreatListUpdatesFetchCall
- func (c *ThreatListUpdatesFetchCall) Context(ctx context.Context) *ThreatListUpdatesFetchCall
- func (c *ThreatListUpdatesFetchCall) Do(opts ...googleapi.CallOption) (*FetchThreatListUpdatesResponse, error)
- func (c *ThreatListUpdatesFetchCall) Fields(s ...googleapi.Field) *ThreatListUpdatesFetchCall
- func (c *ThreatListUpdatesFetchCall) Header() http.Header
- type ThreatListUpdatesService
- type ThreatListsListCall
- func (c *ThreatListsListCall) Context(ctx context.Context) *ThreatListsListCall
- func (c *ThreatListsListCall) Do(opts ...googleapi.CallOption) (*ListThreatListsResponse, error)
- func (c *ThreatListsListCall) Fields(s ...googleapi.Field) *ThreatListsListCall
- func (c *ThreatListsListCall) Header() http.Header
- func (c *ThreatListsListCall) IfNoneMatch(entityTag string) *ThreatListsListCall
- type ThreatListsService
- type ThreatMatch
- type ThreatMatchesFindCall
- func (c *ThreatMatchesFindCall) Context(ctx context.Context) *ThreatMatchesFindCall
- func (c *ThreatMatchesFindCall) Do(opts ...googleapi.CallOption) (*FindThreatMatchesResponse, error)
- func (c *ThreatMatchesFindCall) Fields(s ...googleapi.Field) *ThreatMatchesFindCall
- func (c *ThreatMatchesFindCall) Header() http.Header
- type ThreatMatchesService
- type ThreatSource
- type UserInfo
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Checksum ¶
type Checksum struct { // Sha256: The SHA256 hash of the client state; that is, of the sorted // list of all // hashes present in the database. Sha256 string `json:"sha256,omitempty"` // ForceSendFields is a list of field names (e.g. "Sha256") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Sha256") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Checksum: The expected state of a client's local database.
func (*Checksum) MarshalJSON ¶
type ClientInfo ¶
type ClientInfo struct { // ClientId: A client ID that (hopefully) uniquely identifies the client // implementation // of the Safe Browsing API. ClientId string `json:"clientId,omitempty"` // ClientVersion: The version of the client implementation. ClientVersion string `json:"clientVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "ClientId") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ClientId") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ClientInfo: The client metadata associated with Safe Browsing API requests.
func (*ClientInfo) MarshalJSON ¶
func (s *ClientInfo) MarshalJSON() ([]byte, error)
type Constraints ¶
type Constraints struct { // DeviceLocation: A client's physical location, expressed as a ISO // 31166-1 alpha-2 // region code. DeviceLocation string `json:"deviceLocation,omitempty"` // Language: Requests the lists for a specific language. Expects ISO 639 // alpha-2 // format. Language string `json:"language,omitempty"` // MaxDatabaseEntries: Sets the maximum number of entries that the // client is willing to have // in the local database. This should be a power of 2 between 2**10 // and // 2**20. If zero, no database size limit is set. MaxDatabaseEntries int64 `json:"maxDatabaseEntries,omitempty"` // MaxUpdateEntries: The maximum size in number of entries. The update // will not contain more // entries than this value. This should be a power of 2 between 2**10 // and // 2**20. If zero, no update size limit is set. MaxUpdateEntries int64 `json:"maxUpdateEntries,omitempty"` // Region: Requests the list for a specific geographic location. If not // set the // server may pick that value based on the user's IP address. Expects // ISO // 3166-1 alpha-2 format. Region string `json:"region,omitempty"` // SupportedCompressions: The compression types supported by the client. // // Possible values: // "COMPRESSION_TYPE_UNSPECIFIED" - Unknown. // "RAW" - Raw, uncompressed data. // "RICE" - Rice-Golomb encoded data. SupportedCompressions []string `json:"supportedCompressions,omitempty"` // ForceSendFields is a list of field names (e.g. "DeviceLocation") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "DeviceLocation") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
Constraints: The constraints for this update.
func (*Constraints) MarshalJSON ¶
func (s *Constraints) MarshalJSON() ([]byte, error)
type Empty ¶
type Empty struct { // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` }
Empty: A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:
service Foo { rpc Bar(google.protobuf.Empty) returns
(google.protobuf.Empty);
}
The JSON representation for `Empty` is empty JSON object `{}`.
type EncodedFullHashesGetCall ¶
type EncodedFullHashesGetCall struct {
// contains filtered or unexported fields
}
func (*EncodedFullHashesGetCall) ClientId ¶
func (c *EncodedFullHashesGetCall) ClientId(clientId string) *EncodedFullHashesGetCall
ClientId sets the optional parameter "clientId": A client ID that (hopefully) uniquely identifies the client implementation of the Safe Browsing API.
func (*EncodedFullHashesGetCall) ClientVersion ¶
func (c *EncodedFullHashesGetCall) ClientVersion(clientVersion string) *EncodedFullHashesGetCall
ClientVersion sets the optional parameter "clientVersion": The version of the client implementation.
func (*EncodedFullHashesGetCall) Context ¶
func (c *EncodedFullHashesGetCall) Context(ctx context.Context) *EncodedFullHashesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*EncodedFullHashesGetCall) Do ¶
func (c *EncodedFullHashesGetCall) Do(opts ...googleapi.CallOption) (*FindFullHashesResponse, error)
Do executes the "safebrowsing.encodedFullHashes.get" call. Exactly one of *FindFullHashesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FindFullHashesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*EncodedFullHashesGetCall) Fields ¶
func (c *EncodedFullHashesGetCall) Fields(s ...googleapi.Field) *EncodedFullHashesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*EncodedFullHashesGetCall) Header ¶
func (c *EncodedFullHashesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*EncodedFullHashesGetCall) IfNoneMatch ¶
func (c *EncodedFullHashesGetCall) IfNoneMatch(entityTag string) *EncodedFullHashesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type EncodedFullHashesService ¶
type EncodedFullHashesService struct {
// contains filtered or unexported fields
}
func NewEncodedFullHashesService ¶
func NewEncodedFullHashesService(s *Service) *EncodedFullHashesService
func (*EncodedFullHashesService) Get ¶
func (r *EncodedFullHashesService) Get(encodedRequest string) *EncodedFullHashesGetCall
Get:
type EncodedUpdatesGetCall ¶
type EncodedUpdatesGetCall struct {
// contains filtered or unexported fields
}
func (*EncodedUpdatesGetCall) ClientId ¶
func (c *EncodedUpdatesGetCall) ClientId(clientId string) *EncodedUpdatesGetCall
ClientId sets the optional parameter "clientId": A client ID that uniquely identifies the client implementation of the Safe Browsing API.
func (*EncodedUpdatesGetCall) ClientVersion ¶
func (c *EncodedUpdatesGetCall) ClientVersion(clientVersion string) *EncodedUpdatesGetCall
ClientVersion sets the optional parameter "clientVersion": The version of the client implementation.
func (*EncodedUpdatesGetCall) Context ¶
func (c *EncodedUpdatesGetCall) Context(ctx context.Context) *EncodedUpdatesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*EncodedUpdatesGetCall) Do ¶
func (c *EncodedUpdatesGetCall) Do(opts ...googleapi.CallOption) (*FetchThreatListUpdatesResponse, error)
Do executes the "safebrowsing.encodedUpdates.get" call. Exactly one of *FetchThreatListUpdatesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FetchThreatListUpdatesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*EncodedUpdatesGetCall) Fields ¶
func (c *EncodedUpdatesGetCall) Fields(s ...googleapi.Field) *EncodedUpdatesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*EncodedUpdatesGetCall) Header ¶
func (c *EncodedUpdatesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*EncodedUpdatesGetCall) IfNoneMatch ¶
func (c *EncodedUpdatesGetCall) IfNoneMatch(entityTag string) *EncodedUpdatesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type EncodedUpdatesService ¶
type EncodedUpdatesService struct {
// contains filtered or unexported fields
}
func NewEncodedUpdatesService ¶
func NewEncodedUpdatesService(s *Service) *EncodedUpdatesService
func (*EncodedUpdatesService) Get ¶
func (r *EncodedUpdatesService) Get(encodedRequest string) *EncodedUpdatesGetCall
Get:
type FetchThreatListUpdatesRequest ¶
type FetchThreatListUpdatesRequest struct { // Client: The client metadata. Client *ClientInfo `json:"client,omitempty"` // ListUpdateRequests: The requested threat list updates. ListUpdateRequests []*ListUpdateRequest `json:"listUpdateRequests,omitempty"` // ForceSendFields is a list of field names (e.g. "Client") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Client") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
FetchThreatListUpdatesRequest: Describes a Safe Browsing API update request. Clients can request updates for multiple lists in a single request. NOTE: Field index 2 is unused. NEXT: 5
func (*FetchThreatListUpdatesRequest) MarshalJSON ¶
func (s *FetchThreatListUpdatesRequest) MarshalJSON() ([]byte, error)
type FetchThreatListUpdatesResponse ¶
type FetchThreatListUpdatesResponse struct { // ListUpdateResponses: The list updates requested by the clients. ListUpdateResponses []*ListUpdateResponse `json:"listUpdateResponses,omitempty"` // MinimumWaitDuration: The minimum duration the client must wait before // issuing any update // request. If this field is not set clients may update as soon as they // want. MinimumWaitDuration string `json:"minimumWaitDuration,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "ListUpdateResponses") // to unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ListUpdateResponses") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
func (*FetchThreatListUpdatesResponse) MarshalJSON ¶
func (s *FetchThreatListUpdatesResponse) MarshalJSON() ([]byte, error)
type FindFullHashesRequest ¶
type FindFullHashesRequest struct { // ApiClient: Client metadata associated with callers of higher-level // APIs built on top // of the client's implementation. ApiClient *ClientInfo `json:"apiClient,omitempty"` // Client: The client metadata. Client *ClientInfo `json:"client,omitempty"` // ClientStates: The current client states for each of the client's // local threat lists. ClientStates []string `json:"clientStates,omitempty"` // ThreatInfo: The lists and hashes to be checked. ThreatInfo *ThreatInfo `json:"threatInfo,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiClient") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ApiClient") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
FindFullHashesRequest: Request to return full hashes matched by the provided hash prefixes.
func (*FindFullHashesRequest) MarshalJSON ¶
func (s *FindFullHashesRequest) MarshalJSON() ([]byte, error)
type FindFullHashesResponse ¶
type FindFullHashesResponse struct { // Matches: The full hashes that matched the requested prefixes. Matches []*ThreatMatch `json:"matches,omitempty"` // MinimumWaitDuration: The minimum duration the client must wait before // issuing any find hashes // request. If this field is not set, clients can issue a request as // soon as // they want. MinimumWaitDuration string `json:"minimumWaitDuration,omitempty"` // NegativeCacheDuration: For requested entities that did not match the // threat list, how long to // cache the response. NegativeCacheDuration string `json:"negativeCacheDuration,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Matches") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Matches") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
func (*FindFullHashesResponse) MarshalJSON ¶
func (s *FindFullHashesResponse) MarshalJSON() ([]byte, error)
type FindThreatMatchesRequest ¶
type FindThreatMatchesRequest struct { // Client: The client metadata. Client *ClientInfo `json:"client,omitempty"` // ThreatInfo: The lists and entries to be checked for matches. ThreatInfo *ThreatInfo `json:"threatInfo,omitempty"` // ForceSendFields is a list of field names (e.g. "Client") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Client") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
FindThreatMatchesRequest: Request to check entries against lists.
func (*FindThreatMatchesRequest) MarshalJSON ¶
func (s *FindThreatMatchesRequest) MarshalJSON() ([]byte, error)
type FindThreatMatchesResponse ¶
type FindThreatMatchesResponse struct { // Matches: The threat list matches. Matches []*ThreatMatch `json:"matches,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Matches") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Matches") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
func (*FindThreatMatchesResponse) MarshalJSON ¶
func (s *FindThreatMatchesResponse) MarshalJSON() ([]byte, error)
type FullHashesFindCall ¶
type FullHashesFindCall struct {
// contains filtered or unexported fields
}
func (*FullHashesFindCall) Context ¶
func (c *FullHashesFindCall) Context(ctx context.Context) *FullHashesFindCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*FullHashesFindCall) Do ¶
func (c *FullHashesFindCall) Do(opts ...googleapi.CallOption) (*FindFullHashesResponse, error)
Do executes the "safebrowsing.fullHashes.find" call. Exactly one of *FindFullHashesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FindFullHashesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*FullHashesFindCall) Fields ¶
func (c *FullHashesFindCall) Fields(s ...googleapi.Field) *FullHashesFindCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*FullHashesFindCall) Header ¶
func (c *FullHashesFindCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type FullHashesService ¶
type FullHashesService struct {
// contains filtered or unexported fields
}
func NewFullHashesService ¶
func NewFullHashesService(s *Service) *FullHashesService
func (*FullHashesService) Find ¶
func (r *FullHashesService) Find(findfullhashesrequest *FindFullHashesRequest) *FullHashesFindCall
Find: Finds the full hashes that match the requested hash prefixes.
type ListThreatListsResponse ¶
type ListThreatListsResponse struct { // ThreatLists: The lists available for download by the client. ThreatLists []*ThreatListDescriptor `json:"threatLists,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "ThreatLists") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ThreatLists") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
func (*ListThreatListsResponse) MarshalJSON ¶
func (s *ListThreatListsResponse) MarshalJSON() ([]byte, error)
type ListUpdateRequest ¶
type ListUpdateRequest struct { // Constraints: The constraints associated with this request. Constraints *Constraints `json:"constraints,omitempty"` // PlatformType: The type of platform at risk by entries present in the // list. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformType string `json:"platformType,omitempty"` // State: The current state of the client for the requested list (the // encrypted // client state that was received from the last successful list update). State string `json:"state,omitempty"` // ThreatEntryType: The types of entries present in the list. // // Possible values: // "THREAT_ENTRY_TYPE_UNSPECIFIED" - Unspecified. // "URL" - A URL. // "EXECUTABLE" - An executable program. // "IP_RANGE" - An IP range. // "CHROME_EXTENSION" - Chrome extension. // "FILENAME" - Filename. // "CERT" - CERT ThreatEntryType string `json:"threatEntryType,omitempty"` // ThreatType: The type of threat posed by entries present in the list. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatType string `json:"threatType,omitempty"` // ForceSendFields is a list of field names (e.g. "Constraints") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Constraints") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ListUpdateRequest: A single list update request.
func (*ListUpdateRequest) MarshalJSON ¶
func (s *ListUpdateRequest) MarshalJSON() ([]byte, error)
type ListUpdateResponse ¶
type ListUpdateResponse struct { // Additions: A set of entries to add to a local threat type's list. // Repeated to allow // for a combination of compressed and raw data to be sent in a // single // response. Additions []*ThreatEntrySet `json:"additions,omitempty"` // Checksum: The expected SHA256 hash of the client state; that is, of // the sorted list // of all hashes present in the database after applying the provided // update. // If the client state doesn't match the expected state, the client // must // disregard this update and retry later. Checksum *Checksum `json:"checksum,omitempty"` // NewClientState: The new client state, in encrypted format. Opaque to // clients. NewClientState string `json:"newClientState,omitempty"` // PlatformType: The platform type for which data is returned. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformType string `json:"platformType,omitempty"` // Removals: A set of entries to remove from a local threat type's list. // In practice, // this field is empty or contains exactly one ThreatEntrySet. Removals []*ThreatEntrySet `json:"removals,omitempty"` // ResponseType: The type of response. This may indicate that an action // is required by the // client when the response is received. // // Possible values: // "RESPONSE_TYPE_UNSPECIFIED" - Unknown. // "PARTIAL_UPDATE" - Partial updates are applied to the client's // existing local database. // "FULL_UPDATE" - Full updates replace the client's entire local // database. This means // that either the client was seriously out-of-date or the client // is // believed to be corrupt. ResponseType string `json:"responseType,omitempty"` // ThreatEntryType: The format of the threats. // // Possible values: // "THREAT_ENTRY_TYPE_UNSPECIFIED" - Unspecified. // "URL" - A URL. // "EXECUTABLE" - An executable program. // "IP_RANGE" - An IP range. // "CHROME_EXTENSION" - Chrome extension. // "FILENAME" - Filename. // "CERT" - CERT ThreatEntryType string `json:"threatEntryType,omitempty"` // ThreatType: The threat type for which data is returned. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatType string `json:"threatType,omitempty"` // ForceSendFields is a list of field names (e.g. "Additions") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Additions") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ListUpdateResponse: An update to an individual list.
func (*ListUpdateResponse) MarshalJSON ¶
func (s *ListUpdateResponse) MarshalJSON() ([]byte, error)
type MetadataEntry ¶
type MetadataEntry struct { // Key: The metadata entry key. For JSON requests, the key is // base64-encoded. Key string `json:"key,omitempty"` // Value: The metadata entry value. For JSON requests, the value is // base64-encoded. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Key") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Key") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
MetadataEntry: A single metadata entry.
func (*MetadataEntry) MarshalJSON ¶
func (s *MetadataEntry) MarshalJSON() ([]byte, error)
type RawHashes ¶
type RawHashes struct { // PrefixSize: The number of bytes for each prefix encoded below. This // field can be // anywhere from 4 (shortest prefix) to 32 (full SHA256 hash). PrefixSize int64 `json:"prefixSize,omitempty"` // RawHashes: The hashes, in binary format, concatenated into one long // string. Hashes are // sorted in lexicographic order. For JSON API users, hashes // are // base64-encoded. RawHashes string `json:"rawHashes,omitempty"` // ForceSendFields is a list of field names (e.g. "PrefixSize") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "PrefixSize") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RawHashes: The uncompressed threat entries in hash format of a particular prefix length. Hashes can be anywhere from 4 to 32 bytes in size. A large majority are 4 bytes, but some hashes are lengthened if they collide with the hash of a popular URL.
Used for sending ThreatEntrySet to clients that do not support compression, or when sending non-4-byte hashes to clients that do support compression.
func (*RawHashes) MarshalJSON ¶
type RawIndices ¶
type RawIndices struct { // Indices: The indices to remove from a lexicographically-sorted local // list. Indices []int64 `json:"indices,omitempty"` // ForceSendFields is a list of field names (e.g. "Indices") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Indices") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RawIndices: A set of raw indices to remove from a local list.
func (*RawIndices) MarshalJSON ¶
func (s *RawIndices) MarshalJSON() ([]byte, error)
type RiceDeltaEncoding ¶
type RiceDeltaEncoding struct { // EncodedData: The encoded deltas that are encoded using the // Golomb-Rice coder. EncodedData string `json:"encodedData,omitempty"` // FirstValue: The offset of the first entry in the encoded data, or, if // only a single // integer was encoded, that single integer's value. If the field is // empty or // missing, assume zero. FirstValue int64 `json:"firstValue,omitempty,string"` // NumEntries: The number of entries that are delta encoded in the // encoded data. If only a // single integer was encoded, this will be zero and the single value // will be // stored in `first_value`. NumEntries int64 `json:"numEntries,omitempty"` // RiceParameter: The Golomb-Rice parameter, which is a number between 2 // and 28. This field // is missing (that is, zero) if `num_entries` is zero. RiceParameter int64 `json:"riceParameter,omitempty"` // ForceSendFields is a list of field names (e.g. "EncodedData") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "EncodedData") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RiceDeltaEncoding: The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or compressed removal indices.
func (*RiceDeltaEncoding) MarshalJSON ¶
func (s *RiceDeltaEncoding) MarshalJSON() ([]byte, error)
type Service ¶
type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment EncodedFullHashes *EncodedFullHashesService EncodedUpdates *EncodedUpdatesService FullHashes *FullHashesService ThreatHits *ThreatHitsService ThreatListUpdates *ThreatListUpdatesService ThreatLists *ThreatListsService ThreatMatches *ThreatMatchesService // contains filtered or unexported fields }
type ThreatEntry ¶
type ThreatEntry struct { // Digest: The digest of an executable in SHA256 format. The API // supports both // binary and hex digests. For JSON requests, digests are // base64-encoded. Digest string `json:"digest,omitempty"` // Hash: A hash prefix, consisting of the most significant 4-32 bytes of // a SHA256 // hash. This field is in binary format. For JSON requests, hashes // are // base64-encoded. Hash string `json:"hash,omitempty"` // Url: A URL. Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "Digest") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Digest") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatEntry: An individual threat; for example, a malicious URL or its hash representation. Only one of these fields should be set.
func (*ThreatEntry) MarshalJSON ¶
func (s *ThreatEntry) MarshalJSON() ([]byte, error)
type ThreatEntryMetadata ¶
type ThreatEntryMetadata struct { // Entries: The metadata entries. Entries []*MetadataEntry `json:"entries,omitempty"` // ForceSendFields is a list of field names (e.g. "Entries") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Entries") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatEntryMetadata: The metadata associated with a specific threat entry. The client is expected to know the metadata key/value pairs associated with each threat type.
func (*ThreatEntryMetadata) MarshalJSON ¶
func (s *ThreatEntryMetadata) MarshalJSON() ([]byte, error)
type ThreatEntrySet ¶
type ThreatEntrySet struct { // CompressionType: The compression type for the entries in this set. // // Possible values: // "COMPRESSION_TYPE_UNSPECIFIED" - Unknown. // "RAW" - Raw, uncompressed data. // "RICE" - Rice-Golomb encoded data. CompressionType string `json:"compressionType,omitempty"` // RawHashes: The raw SHA256-formatted entries. RawHashes *RawHashes `json:"rawHashes,omitempty"` // RawIndices: The raw removal indices for a local list. RawIndices *RawIndices `json:"rawIndices,omitempty"` // RiceHashes: The encoded 4-byte prefixes of SHA256-formatted entries, // using a // Golomb-Rice encoding. The hashes are converted to uint32, sorted // in // ascending order, then delta encoded and stored as encoded_data. RiceHashes *RiceDeltaEncoding `json:"riceHashes,omitempty"` // RiceIndices: The encoded local, lexicographically-sorted list // indices, using a // Golomb-Rice encoding. Used for sending compressed removal indices. // The // removal indices (uint32) are sorted in ascending order, then delta // encoded // and stored as encoded_data. RiceIndices *RiceDeltaEncoding `json:"riceIndices,omitempty"` // ForceSendFields is a list of field names (e.g. "CompressionType") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CompressionType") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
ThreatEntrySet: A set of threats that should be added or removed from a client's local database.
func (*ThreatEntrySet) MarshalJSON ¶
func (s *ThreatEntrySet) MarshalJSON() ([]byte, error)
type ThreatHit ¶
type ThreatHit struct { // ClientInfo: Client-reported identification. ClientInfo *ClientInfo `json:"clientInfo,omitempty"` // Entry: The threat entry responsible for the hit. Full hash should be // reported for // hash-based hits. Entry *ThreatEntry `json:"entry,omitempty"` // PlatformType: The platform type reported. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformType string `json:"platformType,omitempty"` // Resources: The resources related to the threat hit. Resources []*ThreatSource `json:"resources,omitempty"` // ThreatType: The threat type reported. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatType string `json:"threatType,omitempty"` // UserInfo: Details about the user that encountered the threat. UserInfo *UserInfo `json:"userInfo,omitempty"` // ForceSendFields is a list of field names (e.g. "ClientInfo") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ClientInfo") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
func (*ThreatHit) MarshalJSON ¶
type ThreatHitsCreateCall ¶
type ThreatHitsCreateCall struct {
// contains filtered or unexported fields
}
func (*ThreatHitsCreateCall) Context ¶
func (c *ThreatHitsCreateCall) Context(ctx context.Context) *ThreatHitsCreateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ThreatHitsCreateCall) Do ¶
func (c *ThreatHitsCreateCall) Do(opts ...googleapi.CallOption) (*Empty, error)
Do executes the "safebrowsing.threatHits.create" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ThreatHitsCreateCall) Fields ¶
func (c *ThreatHitsCreateCall) Fields(s ...googleapi.Field) *ThreatHitsCreateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ThreatHitsCreateCall) Header ¶
func (c *ThreatHitsCreateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ThreatHitsService ¶
type ThreatHitsService struct {
// contains filtered or unexported fields
}
func NewThreatHitsService ¶
func NewThreatHitsService(s *Service) *ThreatHitsService
func (*ThreatHitsService) Create ¶
func (r *ThreatHitsService) Create(threathit *ThreatHit) *ThreatHitsCreateCall
Create: Reports a Safe Browsing threat list hit to Google. Only projects with TRUSTED_REPORTER visibility can use this method.
type ThreatInfo ¶
type ThreatInfo struct { // PlatformTypes: The platform types to be checked. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformTypes []string `json:"platformTypes,omitempty"` // ThreatEntries: The threat entries to be checked. ThreatEntries []*ThreatEntry `json:"threatEntries,omitempty"` // ThreatEntryTypes: The entry types to be checked. // // Possible values: // "THREAT_ENTRY_TYPE_UNSPECIFIED" - Unspecified. // "URL" - A URL. // "EXECUTABLE" - An executable program. // "IP_RANGE" - An IP range. // "CHROME_EXTENSION" - Chrome extension. // "FILENAME" - Filename. // "CERT" - CERT ThreatEntryTypes []string `json:"threatEntryTypes,omitempty"` // ThreatTypes: The threat types to be checked. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatTypes []string `json:"threatTypes,omitempty"` // ForceSendFields is a list of field names (e.g. "PlatformTypes") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "PlatformTypes") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatInfo: The information regarding one or more threats that a client submits when checking for matches in threat lists.
func (*ThreatInfo) MarshalJSON ¶
func (s *ThreatInfo) MarshalJSON() ([]byte, error)
type ThreatListDescriptor ¶
type ThreatListDescriptor struct { // PlatformType: The platform type targeted by the list's entries. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformType string `json:"platformType,omitempty"` // ThreatEntryType: The entry types contained in the list. // // Possible values: // "THREAT_ENTRY_TYPE_UNSPECIFIED" - Unspecified. // "URL" - A URL. // "EXECUTABLE" - An executable program. // "IP_RANGE" - An IP range. // "CHROME_EXTENSION" - Chrome extension. // "FILENAME" - Filename. // "CERT" - CERT ThreatEntryType string `json:"threatEntryType,omitempty"` // ThreatType: The threat type posed by the list's entries. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatType string `json:"threatType,omitempty"` // ForceSendFields is a list of field names (e.g. "PlatformType") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "PlatformType") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatListDescriptor: Describes an individual threat list. A list is defined by three parameters: the type of threat posed, the type of platform targeted by the threat, and the type of entries in the list.
func (*ThreatListDescriptor) MarshalJSON ¶
func (s *ThreatListDescriptor) MarshalJSON() ([]byte, error)
type ThreatListUpdatesFetchCall ¶
type ThreatListUpdatesFetchCall struct {
// contains filtered or unexported fields
}
func (*ThreatListUpdatesFetchCall) Context ¶
func (c *ThreatListUpdatesFetchCall) Context(ctx context.Context) *ThreatListUpdatesFetchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ThreatListUpdatesFetchCall) Do ¶
func (c *ThreatListUpdatesFetchCall) Do(opts ...googleapi.CallOption) (*FetchThreatListUpdatesResponse, error)
Do executes the "safebrowsing.threatListUpdates.fetch" call. Exactly one of *FetchThreatListUpdatesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FetchThreatListUpdatesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ThreatListUpdatesFetchCall) Fields ¶
func (c *ThreatListUpdatesFetchCall) Fields(s ...googleapi.Field) *ThreatListUpdatesFetchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ThreatListUpdatesFetchCall) Header ¶
func (c *ThreatListUpdatesFetchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ThreatListUpdatesService ¶
type ThreatListUpdatesService struct {
// contains filtered or unexported fields
}
func NewThreatListUpdatesService ¶
func NewThreatListUpdatesService(s *Service) *ThreatListUpdatesService
func (*ThreatListUpdatesService) Fetch ¶
func (r *ThreatListUpdatesService) Fetch(fetchthreatlistupdatesrequest *FetchThreatListUpdatesRequest) *ThreatListUpdatesFetchCall
Fetch: Fetches the most recent threat list updates. A client can request updates for multiple lists at once.
type ThreatListsListCall ¶
type ThreatListsListCall struct {
// contains filtered or unexported fields
}
func (*ThreatListsListCall) Context ¶
func (c *ThreatListsListCall) Context(ctx context.Context) *ThreatListsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ThreatListsListCall) Do ¶
func (c *ThreatListsListCall) Do(opts ...googleapi.CallOption) (*ListThreatListsResponse, error)
Do executes the "safebrowsing.threatLists.list" call. Exactly one of *ListThreatListsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListThreatListsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ThreatListsListCall) Fields ¶
func (c *ThreatListsListCall) Fields(s ...googleapi.Field) *ThreatListsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ThreatListsListCall) Header ¶
func (c *ThreatListsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ThreatListsListCall) IfNoneMatch ¶
func (c *ThreatListsListCall) IfNoneMatch(entityTag string) *ThreatListsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ThreatListsService ¶
type ThreatListsService struct {
// contains filtered or unexported fields
}
func NewThreatListsService ¶
func NewThreatListsService(s *Service) *ThreatListsService
func (*ThreatListsService) List ¶
func (r *ThreatListsService) List() *ThreatListsListCall
List: Lists the Safe Browsing threat lists available for download.
type ThreatMatch ¶
type ThreatMatch struct { // CacheDuration: The cache lifetime for the returned match. Clients // must not cache this // response for more than this duration to avoid false positives. CacheDuration string `json:"cacheDuration,omitempty"` // PlatformType: The platform type matching this threat. // // Possible values: // "PLATFORM_TYPE_UNSPECIFIED" - Unknown platform. // "WINDOWS" - Threat posed to Windows. // "LINUX" - Threat posed to Linux. // "ANDROID" - Threat posed to Android. // "OSX" - Threat posed to OS X. // "IOS" - Threat posed to iOS. // "ANY_PLATFORM" - Threat posed to at least one of the defined // platforms. // "ALL_PLATFORMS" - Threat posed to all defined platforms. // "CHROME" - Threat posed to Chrome. PlatformType string `json:"platformType,omitempty"` // Threat: The threat matching this threat. Threat *ThreatEntry `json:"threat,omitempty"` // ThreatEntryMetadata: Optional metadata associated with this threat. ThreatEntryMetadata *ThreatEntryMetadata `json:"threatEntryMetadata,omitempty"` // ThreatEntryType: The threat entry type matching this threat. // // Possible values: // "THREAT_ENTRY_TYPE_UNSPECIFIED" - Unspecified. // "URL" - A URL. // "EXECUTABLE" - An executable program. // "IP_RANGE" - An IP range. // "CHROME_EXTENSION" - Chrome extension. // "FILENAME" - Filename. // "CERT" - CERT ThreatEntryType string `json:"threatEntryType,omitempty"` // ThreatType: The threat type matching this threat. // // Possible values: // "THREAT_TYPE_UNSPECIFIED" - Unknown. // "MALWARE" - Malware threat type. // "SOCIAL_ENGINEERING" - Social engineering threat type. // "UNWANTED_SOFTWARE" - Unwanted software threat type. // "POTENTIALLY_HARMFUL_APPLICATION" - Potentially harmful application // threat type. // "SOCIAL_ENGINEERING_INTERNAL" - Social engineering threat type for // internal use. // "API_ABUSE" - API abuse threat type. // "MALICIOUS_BINARY" - Malicious binary threat type. // "CSD_WHITELIST" - Client side detection whitelist threat type. // "CSD_DOWNLOAD_WHITELIST" - Client side download detection whitelist // threat type. // "CLIENT_INCIDENT" - Client incident threat type. // "CLIENT_INCIDENT_WHITELIST" - Whitelist used when detecting client // incident threats. // This enum was never launched and should be re-used for the next list. // "APK_MALWARE_OFFLINE" - List used for offline APK checks in PAM. // "SUBRESOURCE_FILTER" - Patterns to be used for activating the // subresource filter. Interstitial // will not be shown for patterns from this list. // "SUSPICIOUS" - Entities that are suspected to present a threat. // "TRICK_TO_BILL" - Trick-to-bill threat list. ThreatType string `json:"threatType,omitempty"` // ForceSendFields is a list of field names (e.g. "CacheDuration") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CacheDuration") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatMatch: A match when checking a threat entry in the Safe Browsing threat lists.
func (*ThreatMatch) MarshalJSON ¶
func (s *ThreatMatch) MarshalJSON() ([]byte, error)
type ThreatMatchesFindCall ¶
type ThreatMatchesFindCall struct {
// contains filtered or unexported fields
}
func (*ThreatMatchesFindCall) Context ¶
func (c *ThreatMatchesFindCall) Context(ctx context.Context) *ThreatMatchesFindCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ThreatMatchesFindCall) Do ¶
func (c *ThreatMatchesFindCall) Do(opts ...googleapi.CallOption) (*FindThreatMatchesResponse, error)
Do executes the "safebrowsing.threatMatches.find" call. Exactly one of *FindThreatMatchesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FindThreatMatchesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ThreatMatchesFindCall) Fields ¶
func (c *ThreatMatchesFindCall) Fields(s ...googleapi.Field) *ThreatMatchesFindCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ThreatMatchesFindCall) Header ¶
func (c *ThreatMatchesFindCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ThreatMatchesService ¶
type ThreatMatchesService struct {
// contains filtered or unexported fields
}
func NewThreatMatchesService ¶
func NewThreatMatchesService(s *Service) *ThreatMatchesService
func (*ThreatMatchesService) Find ¶
func (r *ThreatMatchesService) Find(findthreatmatchesrequest *FindThreatMatchesRequest) *ThreatMatchesFindCall
Find: Finds the threat entries that match the Safe Browsing lists.
type ThreatSource ¶
type ThreatSource struct { // Referrer: Referrer of the resource. Only set if the referrer is // available. Referrer string `json:"referrer,omitempty"` // RemoteIp: The remote IP of the resource in ASCII format. Either IPv4 // or IPv6. RemoteIp string `json:"remoteIp,omitempty"` // Type: The type of source reported. // // Possible values: // "THREAT_SOURCE_TYPE_UNSPECIFIED" - Unknown. // "MATCHING_URL" - The URL that matched the threat list (for which // GetFullHash returned a // valid hash). // "TAB_URL" - The final top-level URL of the tab that the client was // browsing when the // match occurred. // "TAB_REDIRECT" - A redirect URL that was fetched before hitting the // final TAB_URL. // "TAB_RESOURCE" - A resource loaded within the final TAB_URL. Type string `json:"type,omitempty"` // Url: The URL of the resource. Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "Referrer") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Referrer") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ThreatSource: A single resource related to a threat hit.
func (*ThreatSource) MarshalJSON ¶
func (s *ThreatSource) MarshalJSON() ([]byte, error)
type UserInfo ¶
type UserInfo struct { // RegionCode: The UN M.49 region code associated with the user's // location. RegionCode string `json:"regionCode,omitempty"` // UserId: Unique user identifier defined by the client. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "RegionCode") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "RegionCode") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
UserInfo: Details about the user that encountered the threat.