--- v18/services/data_link_service.proto 2025-08-05 14:36:13.000000000 +0000 +++ v19/services/data_link_service.proto 2025-08-05 14:36:21.000000000 +0000 @@ -55,11 +56,54 @@ // [RequestError]() rpc CreateDataLink(CreateDataLinkRequest) returns (CreateDataLinkResponse) { option (google.api.http) = { - post: "/v18/customers/{customer_id=*}/dataLinks:create" + post: "/v19/customers/{customer_id=*}/dataLinks:create" body: "*" }; option (google.api.method_signature) = "customer_id,data_link"; } + + // Remove a data link. + // + // List of thrown errors: + // [AuthenticationError]() + // [AuthorizationError]() + // [DatabaseError]() + // [DataLinkError]() + // [FieldError]() + // [HeaderError]() + // [InternalError]() + // [MutateError]() + // [QuotaError]() + // [RequestError]() + rpc RemoveDataLink(RemoveDataLinkRequest) returns (RemoveDataLinkResponse) { + option (google.api.http) = { + post: "/v19/customers/{customer_id=*}/dataLinks:remove" + body: "*" + }; + option (google.api.method_signature) = "customer_id,resource_name"; + } + + // Update a data link. + // + // List of thrown errors: + // [AuthenticationError]() + // [AuthorizationError]() + // [DatabaseError]() + // [DataLinkError]() + // [FieldError]() + // [HeaderError]() + // [InternalError]() + // [MutateError]() + // [QuotaError]() + // [RequestError]() + rpc UpdateDataLink(UpdateDataLinkRequest) returns (UpdateDataLinkResponse) { + option (google.api.http) = { + post: "/v19/customers/{customer_id=*}/dataLinks:update" + body: "*" + }; + option (google.api.method_signature) = + "customer_id,data_link_status,resource_name"; + } } // Request message for @@ -74,10 +118,62 @@ } // Response message for -// [DataLinkService.CreateDataLink][google.ads.googleads.v18.services.DataLinkService.CreateDataLink]. +// [DataLinkService.CreateDataLink][google.ads.googleads.v19.services.DataLinkService.CreateDataLink]. message CreateDataLinkResponse { // Returned for successful operations. Resource name of the data link. string resource_name = 1 [(google.api.resource_reference) = { type: "googleads.googleapis.com/DataLink" + }]; +} + +// Request message for +// [DataLinkService.RemoveDataLink][google.ads.googleads.v19.services.DataLinkService.RemoveDataLink]. +message RemoveDataLinkRequest { + // Required. The ID of the customer for which the data link is updated. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The data link is expected to have a valid resource name. + string resource_name = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DataLink" + } + ]; +} + +// Response message for +// [DataLinkService.RemoveDataLink][google.ads.googleads.v19.services.DataLinkService.RemoveDataLink]. +message RemoveDataLinkResponse { + // Result for the remove request. + string resource_name = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/DataLink" + }]; +} + +// Request message for +// [DataLinkService.UpdateDataLink][google.ads.googleads.v19.services.DataLinkService.UpdateDataLink]. +message UpdateDataLinkRequest { + // Required. The ID of the customer for which the data link is created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The data link status to be updated to. + google.ads.googleads.v19.enums.DataLinkStatusEnum.DataLinkStatus + data_link_status = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The data link is expected to have a valid resource name. + string resource_name = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DataLink" + } + ]; +} + +// Response message for +// [DataLinkService.UpdateDataLink][google.ads.googleads.v19.services.DataLinkService.UpdateDataLink]. +message UpdateDataLinkResponse { + // Returned for successful operations. Resource name of the data link. + string resource_name = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/DataLink" }]; }
/services/data_link_service.proto
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[],[],null,["# /services/data_link_service.proto\n\n```diff\n--- v18/services/data_link_service.proto 2025-08-05 14:36:13.000000000 +0000\n+++ v19/services/data_link_service.proto 2025-08-05 14:36:21.000000000 +0000\n@@ -55,11 +56,54 @@\n // [RequestError]()\n rpc CreateDataLink(CreateDataLinkRequest) returns (CreateDataLinkResponse) {\n option (google.api.http) = {\n- post: \"/v18/customers/{customer_id=*}/dataLinks:create\"\n+ post: \"/v19/customers/{customer_id=*}/dataLinks:create\"\n body: \"*\"\n };\n option (google.api.method_signature) = \"customer_id,data_link\";\n }\n+\n+ // Remove a data link.\n+ //\n+ // List of thrown errors:\n+ // [AuthenticationError]()\n+ // [AuthorizationError]()\n+ // [DatabaseError]()\n+ // [DataLinkError]()\n+ // [FieldError]()\n+ // [HeaderError]()\n+ // [InternalError]()\n+ // [MutateError]()\n+ // [QuotaError]()\n+ // [RequestError]()\n+ rpc RemoveDataLink(RemoveDataLinkRequest) returns (RemoveDataLinkResponse) {\n+ option (google.api.http) = {\n+ post: \"/v19/customers/{customer_id=*}/dataLinks:remove\"\n+ body: \"*\"\n+ };\n+ option (google.api.method_signature) = \"customer_id,resource_name\";\n+ }\n+\n+ // Update a data link.\n+ //\n+ // List of thrown errors:\n+ // [AuthenticationError]()\n+ // [AuthorizationError]()\n+ // [DatabaseError]()\n+ // [DataLinkError]()\n+ // [FieldError]()\n+ // [HeaderError]()\n+ // [InternalError]()\n+ // [MutateError]()\n+ // [QuotaError]()\n+ // [RequestError]()\n+ rpc UpdateDataLink(UpdateDataLinkRequest) returns (UpdateDataLinkResponse) {\n+ option (google.api.http) = {\n+ post: \"/v19/customers/{customer_id=*}/dataLinks:update\"\n+ body: \"*\"\n+ };\n+ option (google.api.method_signature) =\n+ \"customer_id,data_link_status,resource_name\";\n+ }\n }\n\n // Request message for\n@@ -74,10 +118,62 @@\n }\n\n // Response message for\n-// [DataLinkService.CreateDataLink][google.ads.googleads.v18.services.DataLinkService.CreateDataLink].\n+// [DataLinkService.CreateDataLink][google.ads.googleads.v19.services.DataLinkService.CreateDataLink].\n message CreateDataLinkResponse {\n // Returned for successful operations. Resource name of the data link.\n string resource_name = 1 [(google.api.resource_reference) = {\n type: \"googleads.googleapis.com/DataLink\"\n+ }];\n+}\n+\n+// Request message for\n+// [DataLinkService.RemoveDataLink][google.ads.googleads.v19.services.DataLinkService.RemoveDataLink].\n+message RemoveDataLinkRequest {\n+ // Required. The ID of the customer for which the data link is updated.\n+ string customer_id = 1 [(google.api.field_behavior) = REQUIRED];\n+\n+ // Required. The data link is expected to have a valid resource name.\n+ string resource_name = 2 [\n+ (google.api.field_behavior) = REQUIRED,\n+ (google.api.resource_reference) = {\n+ type: \"googleads.googleapis.com/DataLink\"\n+ }\n+ ];\n+}\n+\n+// Response message for\n+// [DataLinkService.RemoveDataLink][google.ads.googleads.v19.services.DataLinkService.RemoveDataLink].\n+message RemoveDataLinkResponse {\n+ // Result for the remove request.\n+ string resource_name = 1 [(google.api.resource_reference) = {\n+ type: \"googleads.googleapis.com/DataLink\"\n+ }];\n+}\n+\n+// Request message for\n+// [DataLinkService.UpdateDataLink][google.ads.googleads.v19.services.DataLinkService.UpdateDataLink].\n+message UpdateDataLinkRequest {\n+ // Required. The ID of the customer for which the data link is created.\n+ string customer_id = 1 [(google.api.field_behavior) = REQUIRED];\n+\n+ // Required. The data link status to be updated to.\n+ google.ads.googleads.v19.enums.DataLinkStatusEnum.DataLinkStatus\n+ data_link_status = 2 [(google.api.field_behavior) = REQUIRED];\n+\n+ // Required. The data link is expected to have a valid resource name.\n+ string resource_name = 3 [\n+ (google.api.field_behavior) = REQUIRED,\n+ (google.api.resource_reference) = {\n+ type: \"googleads.googleapis.com/DataLink\"\n+ }\n+ ];\n+}\n+\n+// Response message for\n+// [DataLinkService.UpdateDataLink][google.ads.googleads.v19.services.DataLinkService.UpdateDataLink].\n+message UpdateDataLinkResponse {\n+ // Returned for successful operations. Resource name of the data link.\n+ string resource_name = 1 [(google.api.resource_reference) = {\n+ type: \"googleads.googleapis.com/DataLink\"\n }];\n }\n```"]]