blob: 014e4075bc3317ca7f82c590a70b0e6fd847dcaf [file] [log] [blame]
Dmitry Frenkel3e17f892020-10-06 16:46:05 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="analyticsadmin_v1alpha.html">Google Analytics Admin API</a> . <a href="analyticsadmin_v1alpha.properties.html">properties</a> . <a href="analyticsadmin_v1alpha.properties.googleAdsLinks.html">googleAdsLinks</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
81 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Creates a GoogleAdsLink.</p>
83<p class="toc_element">
84 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
85<p class="firstline">Deletes a GoogleAdsLink on a property</p>
86<p class="toc_element">
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -080087 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070088<p class="firstline">Lists GoogleAdsLinks on a property.</p>
89<p class="toc_element">
90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
91<p class="firstline">Retrieves the next page of results.</p>
92<p class="toc_element">
93 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
94<p class="firstline">Updates a GoogleAdsLink on a property</p>
95<h3>Method Details</h3>
96<div class="method">
97 <code class="details" id="close">close()</code>
98 <pre>Close httplib2 connections.</pre>
99</div>
100
101<div class="method">
102 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
103 <pre>Creates a GoogleAdsLink.
104
105Args:
106 parent: string, Required. Example format: properties/1234 (required)
107 body: object, The request body.
108 The object takes the form of:
109
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700110{ # A link between an GA4 property and a Google Ads account.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800111 &quot;adsPersonalizationEnabled&quot;: True or False, # Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update it will be defaulted to true.
112 &quot;canManageClients&quot;: True or False, # Output only. If true, this link is for a Google Ads manager account.
113 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Time when this link was originally created.
114 &quot;customerId&quot;: &quot;A String&quot;, # Immutable. Google Ads customer ID.
115 &quot;emailAddress&quot;: &quot;A String&quot;, # Output only. Email address of the user that created the link. An empty string will be returned if the email address can&#x27;t be retrieved.
116 &quot;name&quot;: &quot;A String&quot;, # Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
117 &quot;parent&quot;: &quot;A String&quot;, # Immutable. Format: properties/{propertyId}
118 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Time when this link was last updated.
119}
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700120
121 x__xgafv: string, V1 error format.
122 Allowed values
123 1 - v1 error format
124 2 - v2 error format
125
126Returns:
127 An object of the form:
128
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700129 { # A link between an GA4 property and a Google Ads account.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800130 &quot;adsPersonalizationEnabled&quot;: True or False, # Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update it will be defaulted to true.
131 &quot;canManageClients&quot;: True or False, # Output only. If true, this link is for a Google Ads manager account.
132 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Time when this link was originally created.
133 &quot;customerId&quot;: &quot;A String&quot;, # Immutable. Google Ads customer ID.
134 &quot;emailAddress&quot;: &quot;A String&quot;, # Output only. Email address of the user that created the link. An empty string will be returned if the email address can&#x27;t be retrieved.
135 &quot;name&quot;: &quot;A String&quot;, # Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
136 &quot;parent&quot;: &quot;A String&quot;, # Immutable. Format: properties/{propertyId}
137 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Time when this link was last updated.
138}</pre>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700139</div>
140
141<div class="method">
142 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
143 <pre>Deletes a GoogleAdsLink on a property
144
145Args:
146 name: string, Required. Example format: properties/1234/googleAdsLinks/5678 (required)
147 x__xgafv: string, V1 error format.
148 Allowed values
149 1 - v1 error format
150 2 - v2 error format
151
152Returns:
153 An object of the form:
154
155 { # 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 `{}`.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800156}</pre>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700157</div>
158
159<div class="method">
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800160 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700161 <pre>Lists GoogleAdsLinks on a property.
162
163Args:
164 parent: string, Required. Example format: properties/1234 (required)
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800165 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).
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800166 pageToken: string, A page token, received from a previous `ListGoogleAdsLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListGoogleAdsLinks` must match the call that provided the page token.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700167 x__xgafv: string, V1 error format.
168 Allowed values
169 1 - v1 error format
170 2 - v2 error format
171
172Returns:
173 An object of the form:
174
175 { # Response message for ListGoogleAdsLinks RPC.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800176 &quot;googleAdsLinks&quot;: [ # List of GoogleAdsLinks.
177 { # A link between an GA4 property and a Google Ads account.
178 &quot;adsPersonalizationEnabled&quot;: True or False, # Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update it will be defaulted to true.
179 &quot;canManageClients&quot;: True or False, # Output only. If true, this link is for a Google Ads manager account.
180 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Time when this link was originally created.
181 &quot;customerId&quot;: &quot;A String&quot;, # Immutable. Google Ads customer ID.
182 &quot;emailAddress&quot;: &quot;A String&quot;, # Output only. Email address of the user that created the link. An empty string will be returned if the email address can&#x27;t be retrieved.
183 &quot;name&quot;: &quot;A String&quot;, # Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
184 &quot;parent&quot;: &quot;A String&quot;, # Immutable. Format: properties/{propertyId}
185 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Time when this link was last updated.
186 },
187 ],
188 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
189}</pre>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700190</div>
191
192<div class="method">
193 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
194 <pre>Retrieves the next page of results.
195
196Args:
197 previous_request: The request for the previous page. (required)
198 previous_response: The response from the request for the previous page. (required)
199
200Returns:
201 A request object that you can call &#x27;execute()&#x27; on to request the next
202 page. Returns None if there are no more items in the collection.
203 </pre>
204</div>
205
206<div class="method">
207 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
208 <pre>Updates a GoogleAdsLink on a property
209
210Args:
211 name: string, Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID. (required)
212 body: object, The request body.
213 The object takes the form of:
214
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700215{ # A link between an GA4 property and a Google Ads account.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800216 &quot;adsPersonalizationEnabled&quot;: True or False, # Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update it will be defaulted to true.
217 &quot;canManageClients&quot;: True or False, # Output only. If true, this link is for a Google Ads manager account.
218 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Time when this link was originally created.
219 &quot;customerId&quot;: &quot;A String&quot;, # Immutable. Google Ads customer ID.
220 &quot;emailAddress&quot;: &quot;A String&quot;, # Output only. Email address of the user that created the link. An empty string will be returned if the email address can&#x27;t be retrieved.
221 &quot;name&quot;: &quot;A String&quot;, # Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
222 &quot;parent&quot;: &quot;A String&quot;, # Immutable. Format: properties/{propertyId}
223 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Time when this link was last updated.
224}
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700225
226 updateMask: string, The list of fields to be updated. Omitted fields will not be updated.
227 x__xgafv: string, V1 error format.
228 Allowed values
229 1 - v1 error format
230 2 - v2 error format
231
232Returns:
233 An object of the form:
234
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700235 { # A link between an GA4 property and a Google Ads account.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800236 &quot;adsPersonalizationEnabled&quot;: True or False, # Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update it will be defaulted to true.
237 &quot;canManageClients&quot;: True or False, # Output only. If true, this link is for a Google Ads manager account.
238 &quot;createTime&quot;: &quot;A String&quot;, # Output only. Time when this link was originally created.
239 &quot;customerId&quot;: &quot;A String&quot;, # Immutable. Google Ads customer ID.
240 &quot;emailAddress&quot;: &quot;A String&quot;, # Output only. Email address of the user that created the link. An empty string will be returned if the email address can&#x27;t be retrieved.
241 &quot;name&quot;: &quot;A String&quot;, # Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.
242 &quot;parent&quot;: &quot;A String&quot;, # Immutable. Format: properties/{propertyId}
243 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Time when this link was last updated.
244}</pre>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700245</div>
246
247</body></html>