Debian Codegraph @

docs/dyn/dfareporting_v5.placementGroups.html

raw
1 <html><body>
2 <style>
3
4 body, 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
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, 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="dfareporting_v5.html">Campaign Manager 360 API</a> . <a href="dfareporting_v5.placementGroups.html">placementGroups</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="#get">get(profileId, id, x__xgafv=None)</a></code></p>
82 <p class="firstline">Gets one placement group by ID.</p>
83 <p class="toc_element">
84 <code><a href="#insert">insert(profileId, body=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Inserts a new placement group.</p>
86 <p class="toc_element">
87 <code><a href="#list">list(profileId, activeStatus=None, advertiserIds=None, campaignIds=None, contentCategoryIds=None, directorySiteIds=None, ids=None, maxEndDate=None, maxResults=None, maxStartDate=None, minEndDate=None, minStartDate=None, pageToken=None, placementGroupType=None, placementStrategyIds=None, pricingTypes=None, searchString=None, siteIds=None, sortField=None, sortOrder=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Retrieves a list of placement groups, possibly filtered. This method supports paging.</p>
89 <p class="toc_element">
90 <code><a href="#list_next">list_next()</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(profileId, id, body=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Updates an existing placement group. This method supports patch semantics.</p>
95 <p class="toc_element">
96 <code><a href="#update">update(profileId, body=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Updates an existing placement group.</p>
98 <h3>Method Details</h3>
99 <div class="method">
100 <code class="details" id="close">close()</code>
101 <pre>Close httplib2 connections.</pre>
102 </div>
103
104 <div class="method">
105 <code class="details" id="get">get(profileId, id, x__xgafv=None)</code>
106 <pre>Gets one placement group by ID.
107
108 Args:
109 profileId: string, User profile ID associated with this request. (required)
110 id: string, Placement group ID. (required)
111 x__xgafv: string, V1 error format.
112 Allowed values
113 1 - v1 error format
114 2 - v2 error format
115
116 Returns:
117 An object of the form:
118
119 { # Contains properties of a package or roadblock.
120 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
121 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
122 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
123 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
124 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
125 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
126 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
127 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
128 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
129 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
130 },
131 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
132 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
133 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
134 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
135 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
136 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
137 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
138 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
139 },
140 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
141 &quot;A String&quot;,
142 ],
143 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
144 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
145 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
146 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
147 },
148 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
149 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
150 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
151 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
152 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
153 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
154 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
155 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
156 },
157 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
158 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
159 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
160 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
161 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
162 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
163 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
164 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
165 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
166 },
167 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
168 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
169 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
170 },
171 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
172 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
173 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
174 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
175 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
176 &quot;endDate&quot;: &quot;A String&quot;,
177 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
178 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
179 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
180 { # Pricing Period
181 &quot;endDate&quot;: &quot;A String&quot;,
182 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
183 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
184 &quot;startDate&quot;: &quot;A String&quot;,
185 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
186 },
187 ],
188 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
189 &quot;startDate&quot;: &quot;A String&quot;,
190 &quot;testingStartDate&quot;: &quot;A String&quot;,
191 },
192 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
193 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
194 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
195 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
196 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
197 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
198 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
199 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
200 },
201 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
202 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
203 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
204 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
205 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
206 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
207 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
208 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
209 },
210 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
211 }</pre>
212 </div>
213
214 <div class="method">
215 <code class="details" id="insert">insert(profileId, body=None, x__xgafv=None)</code>
216 <pre>Inserts a new placement group.
217
218 Args:
219 profileId: string, User profile ID associated with this request. (required)
220 body: object, The request body.
221 The object takes the form of:
222
223 { # Contains properties of a package or roadblock.
224 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
225 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
226 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
227 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
228 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
229 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
230 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
231 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
232 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
233 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
234 },
235 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
236 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
237 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
238 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
239 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
240 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
241 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
242 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
243 },
244 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
245 &quot;A String&quot;,
246 ],
247 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
248 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
249 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
250 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
251 },
252 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
253 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
254 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
255 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
256 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
257 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
258 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
259 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
260 },
261 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
262 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
263 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
264 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
265 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
266 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
267 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
268 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
269 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
270 },
271 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
272 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
273 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
274 },
275 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
276 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
277 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
278 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
279 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
280 &quot;endDate&quot;: &quot;A String&quot;,
281 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
282 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
283 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
284 { # Pricing Period
285 &quot;endDate&quot;: &quot;A String&quot;,
286 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
287 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
288 &quot;startDate&quot;: &quot;A String&quot;,
289 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
290 },
291 ],
292 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
293 &quot;startDate&quot;: &quot;A String&quot;,
294 &quot;testingStartDate&quot;: &quot;A String&quot;,
295 },
296 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
297 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
298 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
299 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
300 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
301 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
302 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
303 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
304 },
305 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
306 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
307 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
308 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
309 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
310 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
311 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
312 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
313 },
314 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
315 }
316
317 x__xgafv: string, V1 error format.
318 Allowed values
319 1 - v1 error format
320 2 - v2 error format
321
322 Returns:
323 An object of the form:
324
325 { # Contains properties of a package or roadblock.
326 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
327 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
328 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
329 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
330 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
331 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
332 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
333 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
334 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
335 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
336 },
337 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
338 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
339 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
340 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
341 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
342 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
343 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
344 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
345 },
346 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
347 &quot;A String&quot;,
348 ],
349 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
350 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
351 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
352 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
353 },
354 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
355 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
356 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
357 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
358 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
359 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
360 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
361 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
362 },
363 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
364 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
365 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
366 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
367 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
368 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
369 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
370 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
371 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
372 },
373 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
374 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
375 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
376 },
377 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
378 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
379 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
380 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
381 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
382 &quot;endDate&quot;: &quot;A String&quot;,
383 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
384 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
385 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
386 { # Pricing Period
387 &quot;endDate&quot;: &quot;A String&quot;,
388 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
389 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
390 &quot;startDate&quot;: &quot;A String&quot;,
391 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
392 },
393 ],
394 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
395 &quot;startDate&quot;: &quot;A String&quot;,
396 &quot;testingStartDate&quot;: &quot;A String&quot;,
397 },
398 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
399 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
400 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
401 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
402 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
403 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
404 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
405 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
406 },
407 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
408 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
409 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
410 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
411 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
412 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
413 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
414 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
415 },
416 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
417 }</pre>
418 </div>
419
420 <div class="method">
421 <code class="details" id="list">list(profileId, activeStatus=None, advertiserIds=None, campaignIds=None, contentCategoryIds=None, directorySiteIds=None, ids=None, maxEndDate=None, maxResults=None, maxStartDate=None, minEndDate=None, minStartDate=None, pageToken=None, placementGroupType=None, placementStrategyIds=None, pricingTypes=None, searchString=None, siteIds=None, sortField=None, sortOrder=None, x__xgafv=None)</code>
422 <pre>Retrieves a list of placement groups, possibly filtered. This method supports paging.
423
424 Args:
425 profileId: string, User profile ID associated with this request. (required)
426 activeStatus: string, Select only placements with these active statuses. (repeated)
427 Allowed values
428 PLACEMENT_STATUS_UNKNOWN -
429 PLACEMENT_STATUS_ACTIVE -
430 PLACEMENT_STATUS_INACTIVE -
431 PLACEMENT_STATUS_ARCHIVED -
432 PLACEMENT_STATUS_PERMANENTLY_ARCHIVED -
433 advertiserIds: string, Select only placement groups that belong to these advertisers. (repeated)
434 campaignIds: string, Select only placement groups that belong to these campaigns. (repeated)
435 contentCategoryIds: string, Select only placement groups that are associated with these content categories. (repeated)
436 directorySiteIds: string, Select only placement groups that are associated with these directory sites. (repeated)
437 ids: string, Select only placement groups with these IDs. (repeated)
438 maxEndDate: string, Select only placements or placement groups whose end date is on or before the specified maxEndDate. The date should be formatted as &quot;yyyy-MM-dd&quot;.
439 maxResults: integer, Maximum number of results to return.
440 maxStartDate: string, Select only placements or placement groups whose start date is on or before the specified maxStartDate. The date should be formatted as &quot;yyyy-MM-dd&quot;.
441 minEndDate: string, Select only placements or placement groups whose end date is on or after the specified minEndDate. The date should be formatted as &quot;yyyy-MM-dd&quot;.
442 minStartDate: string, Select only placements or placement groups whose start date is on or after the specified minStartDate. The date should be formatted as &quot;yyyy-MM-dd&quot;.
443 pageToken: string, Value of the nextPageToken from the previous result page.
444 placementGroupType: string, Select only placement groups belonging with this group type. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting.
445 Allowed values
446 PLACEMENT_PACKAGE - A simple group of site-placements (tags). Basically acts as a single pricing point for a group of tags.
447 PLACEMENT_ROADBLOCK - A group of site-placements (tags) that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. This kind of group requires one of its assigned site-placements to be marked as primary for reporting purposes.
448 placementStrategyIds: string, Select only placement groups that are associated with these placement strategies. (repeated)
449 pricingTypes: string, Select only placement groups with these pricing types. (repeated)
450 Allowed values
451 PRICING_TYPE_CPM -
452 PRICING_TYPE_CPC -
453 PRICING_TYPE_CPA -
454 PRICING_TYPE_FLAT_RATE_IMPRESSIONS -
455 PRICING_TYPE_FLAT_RATE_CLICKS -
456 PRICING_TYPE_CPM_ACTIVEVIEW -
457 searchString: string, Allows searching for placement groups by name or ID. Wildcards (*) are allowed. For example, &quot;placement*2015&quot; will return placement groups with names like &quot;placement group June 2015&quot;, &quot;placement group May 2015&quot;, or simply &quot;placements 2015&quot;. Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of &quot;placementgroup&quot; will match placement groups with name &quot;my placementgroup&quot;, &quot;placementgroup 2015&quot;, or simply &quot;placementgroup&quot;.
458 siteIds: string, Select only placement groups that are associated with these sites. (repeated)
459 sortField: string, Field by which to sort the list.
460 Allowed values
461 ID -
462 NAME -
463 sortOrder: string, Order of sorted results.
464 Allowed values
465 ASCENDING - Ascending order.
466 DESCENDING - Descending order.
467 x__xgafv: string, V1 error format.
468 Allowed values
469 1 - v1 error format
470 2 - v2 error format
471
472 Returns:
473 An object of the form:
474
475 { # Placement Group List Response
476 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroupsListResponse&quot;.
477 &quot;nextPageToken&quot;: &quot;A String&quot;, # Pagination token to be used for the next list operation.
478 &quot;placementGroups&quot;: [ # Placement group collection.
479 { # Contains properties of a package or roadblock.
480 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
481 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
482 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
483 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
484 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
485 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
486 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
487 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
488 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
489 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
490 },
491 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
492 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
493 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
494 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
495 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
496 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
497 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
498 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
499 },
500 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
501 &quot;A String&quot;,
502 ],
503 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
504 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
505 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
506 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
507 },
508 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
509 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
510 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
511 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
512 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
513 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
514 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
515 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
516 },
517 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
518 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
519 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
520 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
521 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
522 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
523 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
524 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
525 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
526 },
527 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
528 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
529 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
530 },
531 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
532 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
533 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
534 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
535 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
536 &quot;endDate&quot;: &quot;A String&quot;,
537 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
538 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
539 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
540 { # Pricing Period
541 &quot;endDate&quot;: &quot;A String&quot;,
542 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
543 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
544 &quot;startDate&quot;: &quot;A String&quot;,
545 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
546 },
547 ],
548 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
549 &quot;startDate&quot;: &quot;A String&quot;,
550 &quot;testingStartDate&quot;: &quot;A String&quot;,
551 },
552 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
553 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
554 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
555 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
556 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
557 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
558 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
559 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
560 },
561 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
562 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
563 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
564 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
565 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
566 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
567 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
568 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
569 },
570 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
571 },
572 ],
573 }</pre>
574 </div>
575
576 <div class="method">
577 <code class="details" id="list_next">list_next()</code>
578 <pre>Retrieves the next page of results.
579
580 Args:
581 previous_request: The request for the previous page. (required)
582 previous_response: The response from the request for the previous page. (required)
583
584 Returns:
585 A request object that you can call &#x27;execute()&#x27; on to request the next
586 page. Returns None if there are no more items in the collection.
587 </pre>
588 </div>
589
590 <div class="method">
591 <code class="details" id="patch">patch(profileId, id, body=None, x__xgafv=None)</code>
592 <pre>Updates an existing placement group. This method supports patch semantics.
593
594 Args:
595 profileId: string, User profile ID associated with this request. (required)
596 id: string, Required. Placement ID. (required)
597 body: object, The request body.
598 The object takes the form of:
599
600 { # Contains properties of a package or roadblock.
601 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
602 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
603 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
604 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
605 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
606 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
607 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
608 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
609 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
610 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
611 },
612 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
613 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
614 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
615 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
616 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
617 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
618 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
619 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
620 },
621 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
622 &quot;A String&quot;,
623 ],
624 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
625 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
626 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
627 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
628 },
629 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
630 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
631 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
632 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
633 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
634 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
635 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
636 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
637 },
638 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
639 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
640 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
641 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
642 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
643 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
644 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
645 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
646 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
647 },
648 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
649 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
650 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
651 },
652 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
653 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
654 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
655 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
656 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
657 &quot;endDate&quot;: &quot;A String&quot;,
658 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
659 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
660 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
661 { # Pricing Period
662 &quot;endDate&quot;: &quot;A String&quot;,
663 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
664 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
665 &quot;startDate&quot;: &quot;A String&quot;,
666 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
667 },
668 ],
669 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
670 &quot;startDate&quot;: &quot;A String&quot;,
671 &quot;testingStartDate&quot;: &quot;A String&quot;,
672 },
673 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
674 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
675 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
676 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
677 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
678 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
679 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
680 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
681 },
682 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
683 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
684 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
685 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
686 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
687 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
688 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
689 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
690 },
691 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
692 }
693
694 x__xgafv: string, V1 error format.
695 Allowed values
696 1 - v1 error format
697 2 - v2 error format
698
699 Returns:
700 An object of the form:
701
702 { # Contains properties of a package or roadblock.
703 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
704 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
705 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
706 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
707 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
708 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
709 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
710 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
711 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
712 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
713 },
714 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
715 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
716 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
717 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
718 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
719 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
720 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
721 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
722 },
723 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
724 &quot;A String&quot;,
725 ],
726 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
727 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
728 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
729 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
730 },
731 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
732 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
733 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
734 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
735 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
736 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
737 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
738 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
739 },
740 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
741 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
742 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
743 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
744 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
745 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
746 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
747 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
748 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
749 },
750 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
751 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
752 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
753 },
754 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
755 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
756 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
757 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
758 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
759 &quot;endDate&quot;: &quot;A String&quot;,
760 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
761 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
762 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
763 { # Pricing Period
764 &quot;endDate&quot;: &quot;A String&quot;,
765 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
766 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
767 &quot;startDate&quot;: &quot;A String&quot;,
768 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
769 },
770 ],
771 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
772 &quot;startDate&quot;: &quot;A String&quot;,
773 &quot;testingStartDate&quot;: &quot;A String&quot;,
774 },
775 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
776 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
777 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
778 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
779 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
780 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
781 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
782 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
783 },
784 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
785 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
786 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
787 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
788 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
789 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
790 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
791 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
792 },
793 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
794 }</pre>
795 </div>
796
797 <div class="method">
798 <code class="details" id="update">update(profileId, body=None, x__xgafv=None)</code>
799 <pre>Updates an existing placement group.
800
801 Args:
802 profileId: string, User profile ID associated with this request. (required)
803 body: object, The request body.
804 The object takes the form of:
805
806 { # Contains properties of a package or roadblock.
807 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
808 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
809 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
810 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
811 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
812 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
813 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
814 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
815 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
816 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
817 },
818 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
819 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
820 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
821 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
822 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
823 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
824 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
825 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
826 },
827 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
828 &quot;A String&quot;,
829 ],
830 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
831 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
832 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
833 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
834 },
835 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
836 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
837 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
838 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
839 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
840 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
841 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
842 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
843 },
844 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
845 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
846 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
847 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
848 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
849 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
850 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
851 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
852 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
853 },
854 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
855 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
856 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
857 },
858 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
859 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
860 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
861 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
862 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
863 &quot;endDate&quot;: &quot;A String&quot;,
864 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
865 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
866 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
867 { # Pricing Period
868 &quot;endDate&quot;: &quot;A String&quot;,
869 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
870 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
871 &quot;startDate&quot;: &quot;A String&quot;,
872 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
873 },
874 ],
875 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
876 &quot;startDate&quot;: &quot;A String&quot;,
877 &quot;testingStartDate&quot;: &quot;A String&quot;,
878 },
879 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
880 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
881 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
882 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
883 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
884 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
885 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
886 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
887 },
888 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
889 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
890 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
891 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
892 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
893 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
894 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
895 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
896 },
897 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
898 }
899
900 x__xgafv: string, V1 error format.
901 Allowed values
902 1 - v1 error format
903 2 - v2 error format
904
905 Returns:
906 An object of the form:
907
908 { # Contains properties of a package or roadblock.
909 &quot;accountId&quot;: &quot;A String&quot;, # Account ID of this placement group. This is a read-only field that can be left blank.
910 &quot;activeStatus&quot;: &quot;A String&quot;, # Whether this placement group is active, inactive, archived or permanently archived.
911 &quot;advertiserId&quot;: &quot;A String&quot;, # Advertiser ID of this placement group. This is a required field on insertion.
912 &quot;advertiserIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
913 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
914 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
915 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
916 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
917 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
918 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
919 },
920 &quot;campaignId&quot;: &quot;A String&quot;, # Campaign ID of this placement group. This field is required on insertion.
921 &quot;campaignIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the campaign. This is a read-only, auto-generated field.
922 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
923 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
924 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
925 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
926 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
927 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
928 },
929 &quot;childPlacementIds&quot;: [ # IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field.
930 &quot;A String&quot;,
931 ],
932 &quot;comment&quot;: &quot;A String&quot;, # Comments for this placement group.
933 &quot;contentCategoryId&quot;: &quot;A String&quot;, # ID of the content category assigned to this placement group.
934 &quot;createInfo&quot;: { # Modification timestamp. # Information about the creation of this placement group. This is a read-only field.
935 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
936 },
937 &quot;directorySiteId&quot;: &quot;A String&quot;, # Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
938 &quot;directorySiteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the directory site. This is a read-only, auto-generated field.
939 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
940 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
941 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
942 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
943 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
944 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
945 },
946 &quot;externalId&quot;: &quot;A String&quot;, # External ID for this placement.
947 &quot;id&quot;: &quot;A String&quot;, # ID of this placement group. This is a read-only, auto-generated field.
948 &quot;idDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of this placement group. This is a read-only, auto-generated field.
949 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
950 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
951 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
952 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
953 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
954 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
955 },
956 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#placementGroup&quot;.
957 &quot;lastModifiedInfo&quot;: { # Modification timestamp. # Information about the most recent modification of this placement group. This is a read-only field.
958 &quot;time&quot;: &quot;A String&quot;, # Timestamp of the last change in milliseconds since epoch.
959 },
960 &quot;name&quot;: &quot;A String&quot;, # Name of this placement group. This is a required field and must be less than 256 characters long.
961 &quot;placementGroupType&quot;: &quot;A String&quot;, # Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.
962 &quot;placementStrategyId&quot;: &quot;A String&quot;, # ID of the placement strategy assigned to this placement group.
963 &quot;pricingSchedule&quot;: { # Pricing Schedule # Pricing schedule of this placement group. This field is required on insertion.
964 &quot;capCostOption&quot;: &quot;A String&quot;, # Placement cap cost option.
965 &quot;endDate&quot;: &quot;A String&quot;,
966 &quot;flighted&quot;: True or False, # Whether this placement is flighted. If true, pricing periods will be computed automatically.
967 &quot;floodlightActivityId&quot;: &quot;A String&quot;, # Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.
968 &quot;pricingPeriods&quot;: [ # Pricing periods for this placement.
969 { # Pricing Period
970 &quot;endDate&quot;: &quot;A String&quot;,
971 &quot;pricingComment&quot;: &quot;A String&quot;, # Comments for this pricing period.
972 &quot;rateOrCostNanos&quot;: &quot;A String&quot;, # Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.
973 &quot;startDate&quot;: &quot;A String&quot;,
974 &quot;units&quot;: &quot;A String&quot;, # Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.
975 },
976 ],
977 &quot;pricingType&quot;: &quot;A String&quot;, # Placement pricing type. This field is required on insertion.
978 &quot;startDate&quot;: &quot;A String&quot;,
979 &quot;testingStartDate&quot;: &quot;A String&quot;,
980 },
981 &quot;primaryPlacementId&quot;: &quot;A String&quot;, # ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.
982 &quot;primaryPlacementIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.
983 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
984 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
985 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
986 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
987 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
988 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
989 },
990 &quot;siteId&quot;: &quot;A String&quot;, # Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion.
991 &quot;siteIdDimensionValue&quot;: { # Represents a DimensionValue resource. # Dimension value for the ID of the site. This is a read-only, auto-generated field.
992 &quot;dimensionName&quot;: &quot;A String&quot;, # The name of the dimension.
993 &quot;etag&quot;: &quot;A String&quot;, # The eTag of this response for caching purposes.
994 &quot;id&quot;: &quot;A String&quot;, # The ID associated with the value if available.
995 &quot;kind&quot;: &quot;A String&quot;, # The kind of resource this is, in this case dfareporting#dimensionValue.
996 &quot;matchType&quot;: &quot;A String&quot;, # Determines how the &#x27;value&#x27; field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, &#x27;*&#x27; is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions (&#x27;dfa:paidSearch*&#x27;) allow a matchType other than EXACT.
997 &quot;value&quot;: &quot;A String&quot;, # The value of the dimension.
998 },
999 &quot;subaccountId&quot;: &quot;A String&quot;, # Subaccount ID of this placement group. This is a read-only field that can be left blank.
1000 }</pre>
1001 </div>
1002
1003 </body></html>