Skip to content

Commit 3933f81

Browse files
jessdelacruzsantosjessdelacruzsantos
authored
Merge pull request #133 from square/release/37.1.0.20240604
Generated PR for Release: 37.1.0.20240604
2 parents c9d1333 + 5198f70 commit 3933f81

22 files changed

+764
-15
lines changed

‎doc/api/events.md‎

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
# Events
2+
3+
```python
4+
events_api = client.events
5+
```
6+
7+
## Class Name
8+
9+
`EventsApi`
10+
11+
## Methods
12+
13+
* [Search Events](../../doc/api/events.md#search-events)
14+
* [Disable Events](../../doc/api/events.md#disable-events)
15+
* [Enable Events](../../doc/api/events.md#enable-events)
16+
* [List Event Types](../../doc/api/events.md#list-event-types)
17+
18+
19+
# Search Events
20+
21+
Search for Square API events that occur within a 28-day timeframe.
22+
23+
```python
24+
def search_events(self,
25+
body)
26+
```
27+
28+
## Parameters
29+
30+
| Parameter | Type | Tags | Description |
31+
| --- | --- | --- | --- |
32+
| `body` | [`Search Events Request`](../../doc/models/search-events-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
33+
34+
## Response Type
35+
36+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Search Events Response`](../../doc/models/search-events-response.md).
37+
38+
## Example Usage
39+
40+
```python
41+
body = {}
42+
43+
result = events_api.search_events(body)
44+
print(result)
45+
46+
if result.is_success():
47+
print(result.body)
48+
elif result.is_error():
49+
print(result.errors)
50+
```
51+
52+
53+
# Disable Events
54+
55+
Disables events to prevent them from being searchable.
56+
All events are disabled by default. You must enable events to make them searchable.
57+
Disabling events for a specific time period prevents them from being searchable, even if you re-enable them later.
58+
59+
```python
60+
def disable_events(self)
61+
```
62+
63+
## Response Type
64+
65+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Disable Events Response`](../../doc/models/disable-events-response.md).
66+
67+
## Example Usage
68+
69+
```python
70+
result = events_api.disable_events()
71+
print(result)
72+
73+
if result.is_success():
74+
print(result.body)
75+
elif result.is_error():
76+
print(result.errors)
77+
```
78+
79+
80+
# Enable Events
81+
82+
Enables events to make them searchable. Only events that occur while in the enabled state are searchable.
83+
84+
```python
85+
def enable_events(self)
86+
```
87+
88+
## Response Type
89+
90+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`Enable Events Response`](../../doc/models/enable-events-response.md).
91+
92+
## Example Usage
93+
94+
```python
95+
result = events_api.enable_events()
96+
print(result)
97+
98+
if result.is_success():
99+
print(result.body)
100+
elif result.is_error():
101+
print(result.errors)
102+
```
103+
104+
105+
# List Event Types
106+
107+
Lists all event types that you can subscribe to as webhooks or query using the Events API.
108+
109+
```python
110+
def list_event_types(self,
111+
api_version=None)
112+
```
113+
114+
## Parameters
115+
116+
| Parameter | Type | Tags | Description |
117+
| --- | --- | --- | --- |
118+
| `api_version` | `str` | Query, Optional | The API version for which to list event types. Setting this field overrides the default version used by the application. |
119+
120+
## Response Type
121+
122+
This method returns a `ApiResponse` instance. The `body` property of this instance returns the response data which is of type [`List Event Types Response`](../../doc/models/list-event-types-response.md).
123+
124+
## Example Usage
125+
126+
```python
127+
result = events_api.list_event_types()
128+
print(result)
129+
130+
if result.is_success():
131+
print(result.body)
132+
elif result.is_error():
133+
print(result.errors)
134+
```
135+

‎doc/client.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ The following parameters are configurable for the API Client:
55

66
| Parameter | Type | Description |
77
| --- | --- | --- |
8-
| `square_version` | `str` | Square Connect API versions<br>*Default*: `'2024-05-15'` |
8+
| `square_version` | `str` | Square Connect API versions<br>*Default*: `'2024-06-04'` |
99
| `custom_url` | `str` | Sets the base URL requests are made to. Defaults to `https://connect.squareup.com`<br>*Default*: `'https://connect.squareup.com'` |
1010
| `environment` | `string` | The API environment. <br> **Default: `production`** |
1111
| `http_client_instance` | `HttpClient` | The Http Client passed from the sdk user for making requests |
@@ -24,7 +24,7 @@ The API client can be initialized as follows:
2424

2525
```python
2626
client = Client(
27-
square_version='2024-05-15',
27+
square_version='2024-06-04',
2828
bearer_auth_credentials=BearerAuthCredentials(
2929
access_token='AccessToken'
3030
)
@@ -51,7 +51,7 @@ from square.http.auth.o_auth_2 import BearerAuthCredentials
5151
from square.client import Client
5252

5353
client = Client(
54-
square_version='2024-05-15',
54+
square_version='2024-06-04',
5555
bearer_auth_credentials=BearerAuthCredentials(
5656
access_token='AccessToken'
5757
)
@@ -92,6 +92,7 @@ The gateway for the SDK. This class acts as a factory for the Apis and also hold
9292
| devices | Gets DevicesApi |
9393
| disputes | Gets DisputesApi |
9494
| employees | Gets EmployeesApi |
95+
| events | Gets EventsApi |
9596
| gift_cards | Gets GiftCardsApi |
9697
| gift_card_activities | Gets GiftCardActivitiesApi |
9798
| inventory | Gets InventoryApi |

‎doc/models/disable-events-response.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
2+
# Disable Events Response
3+
4+
Defines the fields that are included in the response body of
5+
a request to the [DisableEvents](../../doc/api/events.md#disable-events) endpoint.
6+
7+
Note: if there are errors processing the request, the events field will not be
8+
present.
9+
10+
## Structure
11+
12+
`Disable Events Response`
13+
14+
## Fields
15+
16+
| Name | Type | Tags | Description |
17+
| --- | --- | --- | --- |
18+
| `errors` | [`List Error`](../../doc/models/error.md) | Optional | Information on errors encountered during the request. |
19+
20+
## Example (as JSON)
21+
22+
```json
23+
{
24+
"errors": [
25+
{
26+
"category": "MERCHANT_SUBSCRIPTION_ERROR",
27+
"code": "MAP_KEY_LENGTH_TOO_LONG",
28+
"detail": "detail6",
29+
"field": "field4"
30+
},
31+
{
32+
"category": "MERCHANT_SUBSCRIPTION_ERROR",
33+
"code": "MAP_KEY_LENGTH_TOO_LONG",
34+
"detail": "detail6",
35+
"field": "field4"
36+
}
37+
]
38+
}
39+
```
40+

‎doc/models/enable-events-response.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
2+
# Enable Events Response
3+
4+
Defines the fields that are included in the response body of
5+
a request to the [EnableEvents](../../doc/api/events.md#enable-events) endpoint.
6+
7+
Note: if there are errors processing the request, the events field will not be
8+
present.
9+
10+
## Structure
11+
12+
`Enable Events Response`
13+
14+
## Fields
15+
16+
| Name | Type | Tags | Description |
17+
| --- | --- | --- | --- |
18+
| `errors` | [`List Error`](../../doc/models/error.md) | Optional | Information on errors encountered during the request. |
19+
20+
## Example (as JSON)
21+
22+
```json
23+
{
24+
"errors": [
25+
{
26+
"category": "MERCHANT_SUBSCRIPTION_ERROR",
27+
"code": "MAP_KEY_LENGTH_TOO_LONG",
28+
"detail": "detail6",
29+
"field": "field4"
30+
}
31+
]
32+
}
33+
```
34+

‎doc/models/event-data.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@
99

1010
| Name | Type | Tags | Description |
1111
| --- | --- | --- | --- |
12-
| `type` | `str` | Optional | Name of the affected object’s type. |
13-
| `id` | `str` | Optional | ID of the affected object. |
14-
| `deleted` | `bool` | Optional | Is true if the affected object was deleted. Otherwise absent. |
15-
| `object` | `dict` | Optional | An object containing fields and values relevant to the event. Is absent if affected object was deleted. |
12+
| `type` | `str` | Optional | The name of the affected object’s type. |
13+
| `id` | `str` | Optional | The ID of the affected object. |
14+
| `deleted` | `bool` | Optional | This is true if the affected object has been deleted; otherwise, it's absent. |
15+
| `object` | `dict` | Optional | An object containing fields and values relevant to the event. It is absent if the affected object has been deleted. |
1616

1717
## Example (as JSON)
1818

‎doc/models/event-metadata.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
2+
# Event Metadata
3+
4+
Contains metadata about a particular [Event](../../doc/models/event.md).
5+
6+
## Structure
7+
8+
`Event Metadata`
9+
10+
## Fields
11+
12+
| Name | Type | Tags | Description |
13+
| --- | --- | --- | --- |
14+
| `event_id` | `str` | Optional | A unique ID for the event. |
15+
| `api_version` | `str` | Optional | The API version of the event. This corresponds to the default API version of the developer application at the time when the event was created. |
16+
17+
## Example (as JSON)
18+
19+
```json
20+
{
21+
"event_id": "event_id0",
22+
"api_version": "api_version6"
23+
}
24+
```
25+

‎doc/models/event.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
| Name | Type | Tags | Description |
1111
| --- | --- | --- | --- |
1212
| `merchant_id` | `str` | Optional | The ID of the target merchant associated with the event. |
13-
| `location_id` | `str` | Optional | The ID of the location associated with the event. |
13+
| `location_id` | `str` | Optional | The ID of the target location associated with the event. |
1414
| `type` | `str` | Optional | The type of event this represents. |
1515
| `event_id` | `str` | Optional | A unique ID for the event. |
1616
| `created_at` | `str` | Optional | Timestamp of when the event was created, in RFC 3339 format. |

‎doc/models/list-event-types-request.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
2+
# List Event Types Request
3+
4+
Lists all event types that can be subscribed to.
5+
6+
## Structure
7+
8+
`List Event Types Request`
9+
10+
## Fields
11+
12+
| Name | Type | Tags | Description |
13+
| --- | --- | --- | --- |
14+
| `api_version` | `str` | Optional | The API version for which to list event types. Setting this field overrides the default version used by the application. |
15+
16+
## Example (as JSON)
17+
18+
```json
19+
{
20+
"api_version": "api_version0"
21+
}
22+
```
23+

‎doc/models/list-event-types-response.md‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
2+
# List Event Types Response
3+
4+
Defines the fields that are included in the response body of
5+
a request to the [ListEventTypes](../../doc/api/events.md#list-event-types) endpoint.
6+
7+
Note: if there are errors processing the request, the event types field will not be
8+
present.
9+
10+
## Structure
11+
12+
`List Event Types Response`
13+
14+
## Fields
15+
16+
| Name | Type | Tags | Description |
17+
| --- | --- | --- | --- |
18+
| `errors` | [`List Error`](../../doc/models/error.md) | Optional | Information on errors encountered during the request. |
19+
| `event_types` | `List[str]` | Optional | The list of event types. |
20+
| `metadata` | [`List Event Type Metadata`](../../doc/models/event-type-metadata.md) | Optional | Contains the metadata of an event type. For more information, see [EventTypeMetadata](entity:EventTypeMetadata). |
21+
22+
## Example (as JSON)
23+
24+
```json
25+
{
26+
"event_types": [
27+
"inventory.count.updated"
28+
],
29+
"metadata": [
30+
{
31+
"api_version_introduced": "2018-07-12",
32+
"event_type": "inventory.count.updated",
33+
"release_status": "PUBLIC"
34+
}
35+
],
36+
"errors": [
37+
{
38+
"category": "MERCHANT_SUBSCRIPTION_ERROR",
39+
"code": "MAP_KEY_LENGTH_TOO_LONG",
40+
"detail": "detail6",
41+
"field": "field4"
42+
},
43+
{
44+
"category": "MERCHANT_SUBSCRIPTION_ERROR",
45+
"code": "MAP_KEY_LENGTH_TOO_LONG",
46+
"detail": "detail6",
47+
"field": "field4"
48+
}
49+
]
50+
}
51+
```
52+

‎doc/models/quantity-ratio.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ A whole number or unreduced fractional ratio.
1212
| Name | Type | Tags | Description |
1313
| --- | --- | --- | --- |
1414
| `quantity` | `int` | Optional | The whole or fractional quantity as the numerator. |
15-
| `quantity_denominator` | `int` | Optional | The whole or fractional quantity as the denominator.<br>In the case of fractional quantity this field is the denominator and quantity is the numerator.<br>When unspecified, the value is `1`. For example, when `quantity=3` and `quantity_donominator` is unspecified,<br>the quantity ratio is `3` or `3/1`. |
15+
| `quantity_denominator` | `int` | Optional | The whole or fractional quantity as the denominator.<br>With fractional quantity this field is the denominator and quantity is the numerator.<br>The default value is `1`. For example, when `quantity=3` and `quantity_denominator` is unspecified,<br>the quantity ratio is `3` or `3/1`. |
1616

1717
## Example (as JSON)
1818

0 commit comments

Comments
 (0)