1// Copyright 2023 Google LLC 2// 3// Licensed under the Apache License, Version 2.0 (the "License"); 4// you may not use this file except in compliance with the License. 5// You may obtain a copy of the License at 6// 7// http://www.apache.org/licenses/LICENSE-2.0 8// 9// Unless required by applicable law or agreed to in writing, software 10// distributed under the License is distributed on an "AS IS" BASIS, 11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12// See the License for the specific language governing permissions and 13// limitations under the License. 14 15syntax = "proto3"; 16 17package google.ads.googleads.v16.resources; 18 19import "google/ads/googleads/v16/enums/account_link_status.proto"; 20import "google/ads/googleads/v16/enums/linked_account_type.proto"; 21import "google/ads/googleads/v16/enums/mobile_app_vendor.proto"; 22import "google/api/field_behavior.proto"; 23import "google/api/resource.proto"; 24 25option csharp_namespace = "Google.Ads.GoogleAds.V16.Resources"; 26option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/resources;resources"; 27option java_multiple_files = true; 28option java_outer_classname = "AccountLinkProto"; 29option java_package = "com.google.ads.googleads.v16.resources"; 30option objc_class_prefix = "GAA"; 31option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Resources"; 32option ruby_package = "Google::Ads::GoogleAds::V16::Resources"; 33 34// Represents the data sharing connection between a Google Ads account and 35// another account 36message AccountLink { 37 option (google.api.resource) = { 38 type: "googleads.googleapis.com/AccountLink" 39 pattern: "customers/{customer_id}/accountLinks/{account_link_id}" 40 }; 41 42 // Immutable. Resource name of the account link. 43 // AccountLink resource names have the form: 44 // `customers/{customer_id}/accountLinks/{account_link_id}` 45 string resource_name = 1 [ 46 (google.api.field_behavior) = IMMUTABLE, 47 (google.api.resource_reference) = { 48 type: "googleads.googleapis.com/AccountLink" 49 } 50 ]; 51 52 // Output only. The ID of the link. 53 // This field is read only. 54 optional int64 account_link_id = 8 55 [(google.api.field_behavior) = OUTPUT_ONLY]; 56 57 // The status of the link. 58 google.ads.googleads.v16.enums.AccountLinkStatusEnum.AccountLinkStatus 59 status = 3; 60 61 // Output only. The type of the linked account. 62 google.ads.googleads.v16.enums.LinkedAccountTypeEnum.LinkedAccountType type = 63 4 [(google.api.field_behavior) = OUTPUT_ONLY]; 64 65 // An account linked to this Google Ads account. 66 oneof linked_account { 67 // Immutable. A third party app analytics link. 68 ThirdPartyAppAnalyticsLinkIdentifier third_party_app_analytics = 5 69 [(google.api.field_behavior) = IMMUTABLE]; 70 } 71} 72 73// The identifiers of a Third Party App Analytics Link. 74message ThirdPartyAppAnalyticsLinkIdentifier { 75 // Immutable. The ID of the app analytics provider. 76 // This field should not be empty when creating a new third 77 // party app analytics link. It is unable to be modified after the creation of 78 // the link. 79 optional int64 app_analytics_provider_id = 4 80 [(google.api.field_behavior) = IMMUTABLE]; 81 82 // Immutable. A string that uniquely identifies a mobile application from 83 // which the data was collected to the Google Ads API. For iOS, the ID string 84 // is the 9 digit string that appears at the end of an App Store URL (for 85 // example, "422689480" for "Gmail" whose App Store link is 86 // https://apps.apple.com/us/app/gmail-email-by-google/id422689480). For 87 // Android, the ID string is the application's package name (for example, 88 // "com.google.android.gm" for "Gmail" given Google Play link 89 // https://play.google.com/store/apps/details?id=com.google.android.gm) 90 // This field should not be empty when creating a new third 91 // party app analytics link. It is unable to be modified after the creation of 92 // the link. 93 optional string app_id = 5 [(google.api.field_behavior) = IMMUTABLE]; 94 95 // Immutable. The vendor of the app. 96 // This field should not be empty when creating a new third 97 // party app analytics link. It is unable to be modified after the creation of 98 // the link. 99 google.ads.googleads.v16.enums.MobileAppVendorEnum.MobileAppVendor 100 app_vendor = 3 [(google.api.field_behavior) = IMMUTABLE]; 101} 102