From dd2c666accfdb01888eed3e3ccf20dbbf81a8f87 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 9 Apr 2024 07:09:31 +0000 Subject: [PATCH] feat(analyticsadmin): update the api #### analyticsadmin:v1alpha The following keys were added: - resources.properties.resources.conversionEvents (Total Keys: 6) - resources.properties.resources.keyEvents.methods.create (Total Keys: 12) - resources.properties.resources.keyEvents.methods.delete (Total Keys: 11) - resources.properties.resources.keyEvents.methods.get (Total Keys: 11) - resources.properties.resources.keyEvents.methods.list (Total Keys: 16) - resources.properties.resources.keyEvents.methods.patch (Total Keys: 15) - schemas.GoogleAnalyticsAdminV1alphaKeyEvent (Total Keys: 19) - schemas.GoogleAnalyticsAdminV1alphaListKeyEventsResponse (Total Keys: 5) #### analyticsadmin:v1beta The following keys were added: - resources.properties.resources.conversionEvents (Total Keys: 6) - resources.properties.resources.keyEvents.methods.create (Total Keys: 12) - resources.properties.resources.keyEvents.methods.delete (Total Keys: 11) - resources.properties.resources.keyEvents.methods.get (Total Keys: 11) - resources.properties.resources.keyEvents.methods.list (Total Keys: 16) - resources.properties.resources.keyEvents.methods.patch (Total Keys: 15) - schemas.GoogleAnalyticsAdminV1betaKeyEvent (Total Keys: 19) - schemas.GoogleAnalyticsAdminV1betaListKeyEventsResponse (Total Keys: 5) --- .../analyticsadmin_v1alpha.properties.html | 5 + ...icsadmin_v1alpha.properties.keyEvents.html | 288 ++++++++++++++++++ .../dyn/analyticsadmin_v1beta.properties.html | 5 + ...ticsadmin_v1beta.properties.keyEvents.html | 288 ++++++++++++++++++ .../documents/analyticsadmin.v1alpha.json | 246 ++++++++++++++- .../documents/analyticsadmin.v1beta.json | 246 ++++++++++++++- 6 files changed, 1076 insertions(+), 2 deletions(-) create mode 100644 docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html create mode 100644 docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.html b/docs/dyn/analyticsadmin_v1alpha.properties.html index 31eceee089..35fc0d6e39 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.html @@ -149,6 +149,11 @@

Instance Methods

Returns the googleAdsLinks Resource.

+

+ keyEvents() +

+

Returns the keyEvents Resource.

+

rollupPropertySourceLinks()

diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html b/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html new file mode 100644 index 0000000000..8fd370a4f4 --- /dev/null +++ b/docs/dyn/analyticsadmin_v1alpha.properties.keyEvents.html @@ -0,0 +1,288 @@ + + + +

Google Analytics Admin API . properties . keyEvents

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, x__xgafv=None)

+

Creates a Key Event.

+

+ delete(name, x__xgafv=None)

+

Deletes a Key Event.

+

+ get(name, x__xgafv=None)

+

Retrieve a single Key Event.

+

+ list(parent, pageSize=None, pageToken=None, x__xgafv=None)

+

Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(name, body=None, updateMask=None, x__xgafv=None)

+

Updates a Key Event.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) +
Creates a Key Event.
+
+Args:
+  parent: string, Required. The resource name of the parent property where this Key Event will be created. Format: properties/123 (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ +
+ delete(name, x__xgafv=None) +
Deletes a Key Event.
+
+Args:
+  name: string, Required. The resource name of the Key Event to delete. Format: properties/{property}/keyEvents/{key_event} Example: "properties/123/keyEvents/456" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # 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); }
+}
+
+ +
+ get(name, x__xgafv=None) +
Retrieve a single Key Event.
+
+Args:
+  name: string, Required. The resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{key_event} Example: "properties/123/keyEvents/456" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ +
+ list(parent, pageSize=None, pageToken=None, x__xgafv=None) +
Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.
+
+Args:
+  parent: string, Required. The resource name of the parent property. Example: 'properties/123' (required)
+  pageSize: integer, The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)
+  pageToken: string, A page token, received from a previous `ListKeyEvents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListKeyEvents` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for ListKeyEvents RPC.
+  "keyEvents": [ # The requested Key Events
+    { # A key event in a Google Analytics property.
+      "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+      "createTime": "A String", # Output only. Time when this key event was created in the property.
+      "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+      "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+        "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+        "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+      },
+      "deletable": True or False, # Output only. If set to true, this event can be deleted.
+      "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+      "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(name, body=None, updateMask=None, x__xgafv=None) +
Updates a Key Event.
+
+Args:
+  name: string, Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+  updateMask: string, Required. The list of fields to be updated. Field names must be in snake case (e.g., "field_to_update"). Omitted fields will not be updated. To replace the entire entity, use one path with the string "*" to match all fields.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/analyticsadmin_v1beta.properties.html b/docs/dyn/analyticsadmin_v1beta.properties.html index 27dfdd408c..d93bedfd69 100644 --- a/docs/dyn/analyticsadmin_v1beta.properties.html +++ b/docs/dyn/analyticsadmin_v1beta.properties.html @@ -104,6 +104,11 @@

Instance Methods

Returns the googleAdsLinks Resource.

+

+ keyEvents() +

+

Returns the keyEvents Resource.

+

acknowledgeUserDataCollection(property, body=None, x__xgafv=None)

Acknowledges the terms of user data collection for the specified property. This acknowledgement must be completed (either in the Google Analytics UI or through this API) before MeasurementProtocolSecret resources may be created.

diff --git a/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html b/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html new file mode 100644 index 0000000000..78826c7886 --- /dev/null +++ b/docs/dyn/analyticsadmin_v1beta.properties.keyEvents.html @@ -0,0 +1,288 @@ + + + +

Google Analytics Admin API . properties . keyEvents

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(parent, body=None, x__xgafv=None)

+

Creates a Key Event.

+

+ delete(name, x__xgafv=None)

+

Deletes a Key Event.

+

+ get(name, x__xgafv=None)

+

Retrieve a single Key Event.

+

+ list(parent, pageSize=None, pageToken=None, x__xgafv=None)

+

Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(name, body=None, updateMask=None, x__xgafv=None)

+

Updates a Key Event.

+

Method Details

+
+ close() +
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) +
Creates a Key Event.
+
+Args:
+  parent: string, Required. The resource name of the parent property where this Key Event will be created. Format: properties/123 (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ +
+ delete(name, x__xgafv=None) +
Deletes a Key Event.
+
+Args:
+  name: string, Required. The resource name of the Key Event to delete. Format: properties/{property}/keyEvents/{key_event} Example: "properties/123/keyEvents/456" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # 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); }
+}
+
+ +
+ get(name, x__xgafv=None) +
Retrieve a single Key Event.
+
+Args:
+  name: string, Required. The resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{key_event} Example: "properties/123/keyEvents/456" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ +
+ list(parent, pageSize=None, pageToken=None, x__xgafv=None) +
Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.
+
+Args:
+  parent: string, Required. The resource name of the parent property. Example: 'properties/123' (required)
+  pageSize: integer, The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)
+  pageToken: string, A page token, received from a previous `ListKeyEvents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListKeyEvents` must match the call that provided the page token.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for ListKeyEvents RPC.
+  "keyEvents": [ # The requested Key Events
+    { # A key event in a Google Analytics property.
+      "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+      "createTime": "A String", # Output only. Time when this key event was created in the property.
+      "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+      "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+        "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+        "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+      },
+      "deletable": True or False, # Output only. If set to true, this event can be deleted.
+      "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+      "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+}
+
+ +
+ list_next() +
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+ +
+ patch(name, body=None, updateMask=None, x__xgafv=None) +
Updates a Key Event.
+
+Args:
+  name: string, Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+  updateMask: string, Required. The list of fields to be updated. Field names must be in snake case (e.g., "field_to_update"). Omitted fields will not be updated. To replace the entire entity, use one path with the string "*" to match all fields.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A key event in a Google Analytics property.
+  "countingMethod": "A String", # Required. The method by which Key Events will be counted across multiple events within a session.
+  "createTime": "A String", # Output only. Time when this key event was created in the property.
+  "custom": True or False, # Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.
+  "defaultValue": { # Defines a default value/currency for a key event. # Optional. Defines a default value/currency for a key event.
+    "currencyCode": "A String", # Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.
+    "numericValue": 3.14, # Required. This will be used to populate the "value" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.
+  },
+  "deletable": True or False, # Output only. If set to true, this event can be deleted.
+  "eventName": "A String", # Immutable. The event name for this key event. Examples: 'click', 'purchase'
+  "name": "A String", # Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}
+}
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json b/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json index 52585e809d..dca5b72c48 100644 --- a/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json @@ -2089,8 +2089,10 @@ } }, "conversionEvents": { +"deprecated": true, "methods": { "create": { +"deprecated": true, "description": "Creates a conversion event with the specified attributes.", "flatPath": "v1alpha/properties/{propertiesId}/conversionEvents", "httpMethod": "POST", @@ -2119,6 +2121,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a conversion event in a property.", "flatPath": "v1alpha/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "DELETE", @@ -2144,6 +2147,7 @@ ] }, "get": { +"deprecated": true, "description": "Retrieve a single conversion event.", "flatPath": "v1alpha/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "GET", @@ -2170,6 +2174,7 @@ ] }, "list": { +"deprecated": true, "description": "Returns a list of conversion events in the specified parent property. Returns an empty list if no conversion events are found.", "flatPath": "v1alpha/properties/{propertiesId}/conversionEvents", "httpMethod": "GET", @@ -2207,6 +2212,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates a conversion event with the specified attributes.", "flatPath": "v1alpha/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "PATCH", @@ -4026,6 +4032,160 @@ } } }, +"keyEvents": { +"methods": { +"create": { +"description": "Creates a Key Event.", +"flatPath": "v1alpha/properties/{propertiesId}/keyEvents", +"httpMethod": "POST", +"id": "analyticsadmin.properties.keyEvents.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The resource name of the parent property where this Key Event will be created. Format: properties/123", +"location": "path", +"pattern": "^properties/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1alpha/{+parent}/keyEvents", +"request": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"response": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +}, +"delete": { +"description": "Deletes a Key Event.", +"flatPath": "v1alpha/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "DELETE", +"id": "analyticsadmin.properties.keyEvents.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the Key Event to delete. Format: properties/{property}/keyEvents/{key_event} Example: \"properties/123/keyEvents/456\"", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1alpha/{+name}", +"response": { +"$ref": "GoogleProtobufEmpty" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +}, +"get": { +"description": "Retrieve a single Key Event.", +"flatPath": "v1alpha/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "GET", +"id": "analyticsadmin.properties.keyEvents.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{key_event} Example: \"properties/123/keyEvents/456\"", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1alpha/{+name}", +"response": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit", +"https://www.googleapis.com/auth/analytics.readonly" +] +}, +"list": { +"description": "Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.", +"flatPath": "v1alpha/properties/{propertiesId}/keyEvents", +"httpMethod": "GET", +"id": "analyticsadmin.properties.keyEvents.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"pageSize": { +"description": "The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `ListKeyEvents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListKeyEvents` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The resource name of the parent property. Example: 'properties/123'", +"location": "path", +"pattern": "^properties/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1alpha/{+parent}/keyEvents", +"response": { +"$ref": "GoogleAnalyticsAdminV1alphaListKeyEventsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit", +"https://www.googleapis.com/auth/analytics.readonly" +] +}, +"patch": { +"description": "Updates a Key Event.", +"flatPath": "v1alpha/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "PATCH", +"id": "analyticsadmin.properties.keyEvents.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1alpha/{+name}", +"request": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"response": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +} +} +}, "rollupPropertySourceLinks": { "methods": { "create": { @@ -4457,7 +4617,7 @@ } } }, -"revision": "20240329", +"revision": "20240405", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -7115,6 +7275,72 @@ }, "type": "object" }, +"GoogleAnalyticsAdminV1alphaKeyEvent": { +"description": "A key event in a Google Analytics property.", +"id": "GoogleAnalyticsAdminV1alphaKeyEvent", +"properties": { +"countingMethod": { +"description": "Required. The method by which Key Events will be counted across multiple events within a session.", +"enum": [ +"COUNTING_METHOD_UNSPECIFIED", +"ONCE_PER_EVENT", +"ONCE_PER_SESSION" +], +"enumDescriptions": [ +"Counting method not specified.", +"Each Event instance is considered a Key Event.", +"An Event instance is considered a Key Event at most once per session per user." +], +"type": "string" +}, +"createTime": { +"description": "Output only. Time when this key event was created in the property.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"custom": { +"description": "Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.", +"readOnly": true, +"type": "boolean" +}, +"defaultValue": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEventDefaultValue", +"description": "Optional. Defines a default value/currency for a key event." +}, +"deletable": { +"description": "Output only. If set to true, this event can be deleted.", +"readOnly": true, +"type": "boolean" +}, +"eventName": { +"description": "Immutable. The event name for this key event. Examples: 'click', 'purchase'", +"type": "string" +}, +"name": { +"description": "Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GoogleAnalyticsAdminV1alphaKeyEventDefaultValue": { +"description": "Defines a default value/currency for a key event.", +"id": "GoogleAnalyticsAdminV1alphaKeyEventDefaultValue", +"properties": { +"currencyCode": { +"description": "Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.", +"type": "string" +}, +"numericValue": { +"description": "Required. This will be used to populate the \"value\" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, "GoogleAnalyticsAdminV1alphaLinkProposalStatusDetails": { "description": "Status information for a link proposal.", "id": "GoogleAnalyticsAdminV1alphaLinkProposalStatusDetails", @@ -7514,6 +7740,24 @@ }, "type": "object" }, +"GoogleAnalyticsAdminV1alphaListKeyEventsResponse": { +"description": "Response message for ListKeyEvents RPC.", +"id": "GoogleAnalyticsAdminV1alphaListKeyEventsResponse", +"properties": { +"keyEvents": { +"description": "The requested Key Events", +"items": { +"$ref": "GoogleAnalyticsAdminV1alphaKeyEvent" +}, +"type": "array" +}, +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" +} +}, +"type": "object" +}, "GoogleAnalyticsAdminV1alphaListMeasurementProtocolSecretsResponse": { "description": "Response message for ListMeasurementProtocolSecret RPC", "id": "GoogleAnalyticsAdminV1alphaListMeasurementProtocolSecretsResponse", diff --git a/googleapiclient/discovery_cache/documents/analyticsadmin.v1beta.json b/googleapiclient/discovery_cache/documents/analyticsadmin.v1beta.json index 0f53305cef..3bc3108420 100644 --- a/googleapiclient/discovery_cache/documents/analyticsadmin.v1beta.json +++ b/googleapiclient/discovery_cache/documents/analyticsadmin.v1beta.json @@ -626,8 +626,10 @@ }, "resources": { "conversionEvents": { +"deprecated": true, "methods": { "create": { +"deprecated": true, "description": "Creates a conversion event with the specified attributes.", "flatPath": "v1beta/properties/{propertiesId}/conversionEvents", "httpMethod": "POST", @@ -656,6 +658,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a conversion event in a property.", "flatPath": "v1beta/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "DELETE", @@ -681,6 +684,7 @@ ] }, "get": { +"deprecated": true, "description": "Retrieve a single conversion event.", "flatPath": "v1beta/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "GET", @@ -707,6 +711,7 @@ ] }, "list": { +"deprecated": true, "description": "Returns a list of conversion events in the specified parent property. Returns an empty list if no conversion events are found.", "flatPath": "v1beta/properties/{propertiesId}/conversionEvents", "httpMethod": "GET", @@ -744,6 +749,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates a conversion event with the specified attributes.", "flatPath": "v1beta/properties/{propertiesId}/conversionEvents/{conversionEventsId}", "httpMethod": "PATCH", @@ -1624,11 +1630,165 @@ ] } } +}, +"keyEvents": { +"methods": { +"create": { +"description": "Creates a Key Event.", +"flatPath": "v1beta/properties/{propertiesId}/keyEvents", +"httpMethod": "POST", +"id": "analyticsadmin.properties.keyEvents.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The resource name of the parent property where this Key Event will be created. Format: properties/123", +"location": "path", +"pattern": "^properties/[^/]+$", +"required": true, +"type": "string" } +}, +"path": "v1beta/{+parent}/keyEvents", +"request": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"response": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +}, +"delete": { +"description": "Deletes a Key Event.", +"flatPath": "v1beta/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "DELETE", +"id": "analyticsadmin.properties.keyEvents.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the Key Event to delete. Format: properties/{property}/keyEvents/{key_event} Example: \"properties/123/keyEvents/456\"", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta/{+name}", +"response": { +"$ref": "GoogleProtobufEmpty" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +}, +"get": { +"description": "Retrieve a single Key Event.", +"flatPath": "v1beta/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "GET", +"id": "analyticsadmin.properties.keyEvents.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{key_event} Example: \"properties/123/keyEvents/456\"", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" } +}, +"path": "v1beta/{+name}", +"response": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit", +"https://www.googleapis.com/auth/analytics.readonly" +] +}, +"list": { +"description": "Returns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.", +"flatPath": "v1beta/properties/{propertiesId}/keyEvents", +"httpMethod": "GET", +"id": "analyticsadmin.properties.keyEvents.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"pageSize": { +"description": "The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `ListKeyEvents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListKeyEvents` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The resource name of the parent property. Example: 'properties/123'", +"location": "path", +"pattern": "^properties/[^/]+$", +"required": true, +"type": "string" } }, -"revision": "20240329", +"path": "v1beta/{+parent}/keyEvents", +"response": { +"$ref": "GoogleAnalyticsAdminV1betaListKeyEventsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit", +"https://www.googleapis.com/auth/analytics.readonly" +] +}, +"patch": { +"description": "Updates a Key Event.", +"flatPath": "v1beta/properties/{propertiesId}/keyEvents/{keyEventsId}", +"httpMethod": "PATCH", +"id": "analyticsadmin.properties.keyEvents.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}", +"location": "path", +"pattern": "^properties/[^/]+/keyEvents/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. The list of fields to be updated. Field names must be in snake case (e.g., \"field_to_update\"). Omitted fields will not be updated. To replace the entire entity, use one path with the string \"*\" to match all fields.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1beta/{+name}", +"request": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"response": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/analytics.edit" +] +} +} +} +} +} +}, +"revision": "20240405", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1betaAccessBetweenFilter": { @@ -2651,6 +2811,72 @@ }, "type": "object" }, +"GoogleAnalyticsAdminV1betaKeyEvent": { +"description": "A key event in a Google Analytics property.", +"id": "GoogleAnalyticsAdminV1betaKeyEvent", +"properties": { +"countingMethod": { +"description": "Required. The method by which Key Events will be counted across multiple events within a session.", +"enum": [ +"COUNTING_METHOD_UNSPECIFIED", +"ONCE_PER_EVENT", +"ONCE_PER_SESSION" +], +"enumDescriptions": [ +"Counting method not specified.", +"Each Event instance is considered a Key Event.", +"An Event instance is considered a Key Event at most once per session per user." +], +"type": "string" +}, +"createTime": { +"description": "Output only. Time when this key event was created in the property.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"custom": { +"description": "Output only. If set to true, this key event refers to a custom event. If set to false, this key event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom key events that may be created per property.", +"readOnly": true, +"type": "boolean" +}, +"defaultValue": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEventDefaultValue", +"description": "Optional. Defines a default value/currency for a key event." +}, +"deletable": { +"description": "Output only. If set to true, this event can be deleted.", +"readOnly": true, +"type": "boolean" +}, +"eventName": { +"description": "Immutable. The event name for this key event. Examples: 'click', 'purchase'", +"type": "string" +}, +"name": { +"description": "Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{key_event}", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GoogleAnalyticsAdminV1betaKeyEventDefaultValue": { +"description": "Defines a default value/currency for a key event.", +"id": "GoogleAnalyticsAdminV1betaKeyEventDefaultValue", +"properties": { +"currencyCode": { +"description": "Required. When an occurrence of this Key Event (specified by event_name) has no set currency this currency will be applied as the default. Must be in ISO 4217 currency code format. See https://en.wikipedia.org/wiki/ISO_4217 for more information.", +"type": "string" +}, +"numericValue": { +"description": "Required. This will be used to populate the \"value\" parameter for all occurrences of this Key Event (specified by event_name) where that parameter is unset.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, "GoogleAnalyticsAdminV1betaListAccountSummariesResponse": { "description": "Response message for ListAccountSummaries RPC.", "id": "GoogleAnalyticsAdminV1betaListAccountSummariesResponse", @@ -2795,6 +3021,24 @@ }, "type": "object" }, +"GoogleAnalyticsAdminV1betaListKeyEventsResponse": { +"description": "Response message for ListKeyEvents RPC.", +"id": "GoogleAnalyticsAdminV1betaListKeyEventsResponse", +"properties": { +"keyEvents": { +"description": "The requested Key Events", +"items": { +"$ref": "GoogleAnalyticsAdminV1betaKeyEvent" +}, +"type": "array" +}, +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" +} +}, +"type": "object" +}, "GoogleAnalyticsAdminV1betaListMeasurementProtocolSecretsResponse": { "description": "Response message for ListMeasurementProtocolSecret RPC", "id": "GoogleAnalyticsAdminV1betaListMeasurementProtocolSecretsResponse",