|
110 | 110 | "resources": { |
111 | 111 | "organizations": { |
112 | 112 | "methods": { |
| 113 | + "findSalesPartnerManagedClients": { |
| 114 | + "description": "Returns a list of clients managed by the sales partner organization. User needs to be an OrgAdmin/BillingAdmin on the sales partner organization in order to view the end clients.", |
| 115 | + "flatPath": "v1alpha/organizations/{organizationsId}:findSalesPartnerManagedClients", |
| 116 | + "httpMethod": "POST", |
| 117 | + "id": "marketingplatformadmin.organizations.findSalesPartnerManagedClients", |
| 118 | + "parameterOrder": [ |
| 119 | + "organization" |
| 120 | + ], |
| 121 | + "parameters": { |
| 122 | + "organization": { |
| 123 | + "description": "Required. The name of the sales partner organization. Format: organizations/{org_id}", |
| 124 | + "location": "path", |
| 125 | + "pattern": "^organizations/[^/]+$", |
| 126 | + "required": true, |
| 127 | + "type": "string" |
| 128 | + } |
| 129 | + }, |
| 130 | + "path": "v1alpha/{+organization}:findSalesPartnerManagedClients", |
| 131 | + "request": { |
| 132 | + "$ref": "FindSalesPartnerManagedClientsRequest" |
| 133 | + }, |
| 134 | + "response": { |
| 135 | + "$ref": "FindSalesPartnerManagedClientsResponse" |
| 136 | + }, |
| 137 | + "scopes": [ |
| 138 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.read", |
| 139 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.update" |
| 140 | + ] |
| 141 | + }, |
113 | 142 | "get": { |
114 | 143 | "description": "Lookup for a single organization.", |
115 | 144 | "flatPath": "v1alpha/organizations/{organizationsId}", |
|
135 | 164 | "https://www.googleapis.com/auth/marketingplatformadmin.analytics.read", |
136 | 165 | "https://www.googleapis.com/auth/marketingplatformadmin.analytics.update" |
137 | 166 | ] |
| 167 | + }, |
| 168 | + "list": { |
| 169 | + "description": "Returns a list of organizations that the user has access to.", |
| 170 | + "flatPath": "v1alpha/organizations", |
| 171 | + "httpMethod": "GET", |
| 172 | + "id": "marketingplatformadmin.organizations.list", |
| 173 | + "parameterOrder": [], |
| 174 | + "parameters": { |
| 175 | + "pageSize": { |
| 176 | + "description": "Optional. The maximum number of organizations to return in one call. The service may return fewer than this value. If unspecified, at most 50 organizations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", |
| 177 | + "format": "int32", |
| 178 | + "location": "query", |
| 179 | + "type": "integer" |
| 180 | + }, |
| 181 | + "pageToken": { |
| 182 | + "description": "Optional. A page token, received from a previous ListOrganizations call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListOrganizations` must match the call that provided the page token.", |
| 183 | + "location": "query", |
| 184 | + "type": "string" |
| 185 | + } |
| 186 | + }, |
| 187 | + "path": "v1alpha/organizations", |
| 188 | + "response": { |
| 189 | + "$ref": "ListOrganizationsResponse" |
| 190 | + }, |
| 191 | + "scopes": [ |
| 192 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.read", |
| 193 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.update" |
| 194 | + ] |
| 195 | + }, |
| 196 | + "reportPropertyUsage": { |
| 197 | + "description": "Get the usage and billing data for properties within the organization for the specified month. Per direct client org, user needs to be OrgAdmin/BillingAdmin on the organization in order to view the billing and usage data. Per sales partner client org, user needs to be OrgAdmin/BillingAdmin on the sales partner org in order to view the billing and usage data, or OrgAdmin/BillingAdmin on the sales partner client org in order to view the usage data only.", |
| 198 | + "flatPath": "v1alpha/organizations/{organizationsId}:reportPropertyUsage", |
| 199 | + "httpMethod": "POST", |
| 200 | + "id": "marketingplatformadmin.organizations.reportPropertyUsage", |
| 201 | + "parameterOrder": [ |
| 202 | + "organization" |
| 203 | + ], |
| 204 | + "parameters": { |
| 205 | + "organization": { |
| 206 | + "description": "Required. Specifies the organization whose property usage will be listed. Format: organizations/{org_id}", |
| 207 | + "location": "path", |
| 208 | + "pattern": "^organizations/[^/]+$", |
| 209 | + "required": true, |
| 210 | + "type": "string" |
| 211 | + } |
| 212 | + }, |
| 213 | + "path": "v1alpha/{+organization}:reportPropertyUsage", |
| 214 | + "request": { |
| 215 | + "$ref": "ReportPropertyUsageRequest" |
| 216 | + }, |
| 217 | + "response": { |
| 218 | + "$ref": "ReportPropertyUsageResponse" |
| 219 | + }, |
| 220 | + "scopes": [ |
| 221 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.read", |
| 222 | + "https://www.googleapis.com/auth/marketingplatformadmin.analytics.update" |
| 223 | + ] |
138 | 224 | } |
139 | 225 | }, |
140 | 226 | "resources": { |
|
263 | 349 | } |
264 | 350 | } |
265 | 351 | }, |
266 | | - "revision": "20240529", |
| 352 | + "revision": "20251029", |
267 | 353 | "rootUrl": "https://marketingplatformadmin.googleapis.com/", |
268 | 354 | "schemas": { |
269 | 355 | "AnalyticsAccountLink": { |
|
301 | 387 | }, |
302 | 388 | "type": "object" |
303 | 389 | }, |
| 390 | + "BillInfo": { |
| 391 | + "description": "Contains the bill amount.", |
| 392 | + "id": "BillInfo", |
| 393 | + "properties": { |
| 394 | + "baseFee": { |
| 395 | + "$ref": "Money", |
| 396 | + "description": "The amount of the monthly base fee." |
| 397 | + }, |
| 398 | + "eventFee": { |
| 399 | + "$ref": "Money", |
| 400 | + "description": "The amount of the event fee." |
| 401 | + }, |
| 402 | + "priceProtectionCredit": { |
| 403 | + "$ref": "Money", |
| 404 | + "description": "The amount of the price protection credit, this is only available for eligible customers." |
| 405 | + }, |
| 406 | + "total": { |
| 407 | + "$ref": "Money", |
| 408 | + "description": "The total amount of the bill." |
| 409 | + } |
| 410 | + }, |
| 411 | + "type": "object" |
| 412 | + }, |
| 413 | + "ClientData": { |
| 414 | + "description": "Contains the client data.", |
| 415 | + "id": "ClientData", |
| 416 | + "properties": { |
| 417 | + "endDate": { |
| 418 | + "$ref": "Date", |
| 419 | + "description": "The end date of the contract between the sales org and the end client." |
| 420 | + }, |
| 421 | + "organization": { |
| 422 | + "$ref": "Organization", |
| 423 | + "description": "The end client that has/had contract with the requested sales org." |
| 424 | + }, |
| 425 | + "startDate": { |
| 426 | + "$ref": "Date", |
| 427 | + "description": "The start date of the contract between the sales org and the end client." |
| 428 | + } |
| 429 | + }, |
| 430 | + "type": "object" |
| 431 | + }, |
| 432 | + "Date": { |
| 433 | + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", |
| 434 | + "id": "Date", |
| 435 | + "properties": { |
| 436 | + "day": { |
| 437 | + "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", |
| 438 | + "format": "int32", |
| 439 | + "type": "integer" |
| 440 | + }, |
| 441 | + "month": { |
| 442 | + "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", |
| 443 | + "format": "int32", |
| 444 | + "type": "integer" |
| 445 | + }, |
| 446 | + "year": { |
| 447 | + "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", |
| 448 | + "format": "int32", |
| 449 | + "type": "integer" |
| 450 | + } |
| 451 | + }, |
| 452 | + "type": "object" |
| 453 | + }, |
304 | 454 | "Empty": { |
305 | 455 | "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", |
306 | 456 | "id": "Empty", |
307 | 457 | "properties": {}, |
308 | 458 | "type": "object" |
309 | 459 | }, |
| 460 | + "FindSalesPartnerManagedClientsRequest": { |
| 461 | + "description": "Request message for FindSalesPartnerManagedClients RPC.", |
| 462 | + "id": "FindSalesPartnerManagedClientsRequest", |
| 463 | + "properties": { |
| 464 | + "isActive": { |
| 465 | + "description": "Optional. If set, only active and just ended clients will be returned.", |
| 466 | + "type": "boolean" |
| 467 | + } |
| 468 | + }, |
| 469 | + "type": "object" |
| 470 | + }, |
| 471 | + "FindSalesPartnerManagedClientsResponse": { |
| 472 | + "description": "Response message for FindSalesPartnerManagedClients RPC.", |
| 473 | + "id": "FindSalesPartnerManagedClientsResponse", |
| 474 | + "properties": { |
| 475 | + "clientData": { |
| 476 | + "description": "The clients managed by the sales org.", |
| 477 | + "items": { |
| 478 | + "$ref": "ClientData" |
| 479 | + }, |
| 480 | + "type": "array" |
| 481 | + } |
| 482 | + }, |
| 483 | + "type": "object" |
| 484 | + }, |
310 | 485 | "ListAnalyticsAccountLinksResponse": { |
311 | 486 | "description": "Response message for ListAnalyticsAccountLinks RPC.", |
312 | 487 | "id": "ListAnalyticsAccountLinksResponse", |
|
325 | 500 | }, |
326 | 501 | "type": "object" |
327 | 502 | }, |
| 503 | + "ListOrganizationsResponse": { |
| 504 | + "description": "Response message for ListOrganizations RPC.", |
| 505 | + "id": "ListOrganizationsResponse", |
| 506 | + "properties": { |
| 507 | + "nextPageToken": { |
| 508 | + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", |
| 509 | + "type": "string" |
| 510 | + }, |
| 511 | + "organizations": { |
| 512 | + "description": "The Organization resource that the user has access to, which includes the org id and display name.", |
| 513 | + "items": { |
| 514 | + "$ref": "Organization" |
| 515 | + }, |
| 516 | + "type": "array" |
| 517 | + } |
| 518 | + }, |
| 519 | + "type": "object" |
| 520 | + }, |
| 521 | + "Money": { |
| 522 | + "description": "Represents an amount of money with its currency type.", |
| 523 | + "id": "Money", |
| 524 | + "properties": { |
| 525 | + "currencyCode": { |
| 526 | + "description": "The three-letter currency code defined in ISO 4217.", |
| 527 | + "type": "string" |
| 528 | + }, |
| 529 | + "nanos": { |
| 530 | + "description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", |
| 531 | + "format": "int32", |
| 532 | + "type": "integer" |
| 533 | + }, |
| 534 | + "units": { |
| 535 | + "description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", |
| 536 | + "format": "int64", |
| 537 | + "type": "string" |
| 538 | + } |
| 539 | + }, |
| 540 | + "type": "object" |
| 541 | + }, |
328 | 542 | "Organization": { |
329 | 543 | "description": "A resource message representing a Google Marketing Platform organization.", |
330 | 544 | "id": "Organization", |
|
340 | 554 | }, |
341 | 555 | "type": "object" |
342 | 556 | }, |
| 557 | + "PropertyUsage": { |
| 558 | + "description": "Contains the count of events received by the property, along with metadata that influences the volume of `billable` events.", |
| 559 | + "id": "PropertyUsage", |
| 560 | + "properties": { |
| 561 | + "accountId": { |
| 562 | + "description": "The ID of the property's parent account.", |
| 563 | + "format": "int64", |
| 564 | + "type": "string" |
| 565 | + }, |
| 566 | + "billableEventCount": { |
| 567 | + "description": "The number of events for which the property is billed in the requested month.", |
| 568 | + "format": "int64", |
| 569 | + "type": "string" |
| 570 | + }, |
| 571 | + "displayName": { |
| 572 | + "description": "The display name of the property.", |
| 573 | + "type": "string" |
| 574 | + }, |
| 575 | + "property": { |
| 576 | + "description": "The name of the Google Analytics Admin API property resource. Format: analyticsadmin.googleapis.com/properties/{property_id}", |
| 577 | + "type": "string" |
| 578 | + }, |
| 579 | + "propertyType": { |
| 580 | + "description": "The subtype of the analytics property. This affects the billable event count.", |
| 581 | + "enum": [ |
| 582 | + "ANALYTICS_PROPERTY_TYPE_UNSPECIFIED", |
| 583 | + "ANALYTICS_PROPERTY_TYPE_ORDINARY", |
| 584 | + "ANALYTICS_PROPERTY_TYPE_SUBPROPERTY", |
| 585 | + "ANALYTICS_PROPERTY_TYPE_ROLLUP" |
| 586 | + ], |
| 587 | + "enumDescriptions": [ |
| 588 | + "Unknown or unspecified property type", |
| 589 | + "Ordinary Google Analytics property", |
| 590 | + "Google Analytics subproperty", |
| 591 | + "Google Analytics rollup property" |
| 592 | + ], |
| 593 | + "type": "string" |
| 594 | + }, |
| 595 | + "serviceLevel": { |
| 596 | + "description": "The service level of the property.", |
| 597 | + "enum": [ |
| 598 | + "ANALYTICS_SERVICE_LEVEL_UNSPECIFIED", |
| 599 | + "ANALYTICS_SERVICE_LEVEL_STANDARD", |
| 600 | + "ANALYTICS_SERVICE_LEVEL_360" |
| 601 | + ], |
| 602 | + "enumDescriptions": [ |
| 603 | + "Service level unspecified.", |
| 604 | + "The standard version of Google Analytics.", |
| 605 | + "The premium version of Google Analytics." |
| 606 | + ], |
| 607 | + "type": "string" |
| 608 | + }, |
| 609 | + "totalEventCount": { |
| 610 | + "description": "Total event count that the property received during the requested month.", |
| 611 | + "format": "int64", |
| 612 | + "type": "string" |
| 613 | + } |
| 614 | + }, |
| 615 | + "type": "object" |
| 616 | + }, |
| 617 | + "ReportPropertyUsageRequest": { |
| 618 | + "description": "Request message for ReportPropertyUsage RPC.", |
| 619 | + "id": "ReportPropertyUsageRequest", |
| 620 | + "properties": { |
| 621 | + "month": { |
| 622 | + "description": "Required. The target month to list property usages. Format: YYYY-MM. For example, \"2025-05\"", |
| 623 | + "type": "string" |
| 624 | + } |
| 625 | + }, |
| 626 | + "type": "object" |
| 627 | + }, |
| 628 | + "ReportPropertyUsageResponse": { |
| 629 | + "description": "Response message for ReportPropertyUsage RPC.", |
| 630 | + "id": "ReportPropertyUsageResponse", |
| 631 | + "properties": { |
| 632 | + "billInfo": { |
| 633 | + "$ref": "BillInfo", |
| 634 | + "description": "Bill amount in the specified organization and month. Will be empty if user only has access to usage data." |
| 635 | + }, |
| 636 | + "propertyUsages": { |
| 637 | + "description": "Usage data for all properties in the specified organization and month.", |
| 638 | + "items": { |
| 639 | + "$ref": "PropertyUsage" |
| 640 | + }, |
| 641 | + "type": "array" |
| 642 | + } |
| 643 | + }, |
| 644 | + "type": "object" |
| 645 | + }, |
343 | 646 | "SetPropertyServiceLevelRequest": { |
344 | 647 | "description": "Request message for SetPropertyServiceLevel RPC.", |
345 | 648 | "id": "SetPropertyServiceLevelRequest", |
|
0 commit comments