// Copyright 2023 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

package google.ads.admanager.v1;

import "google/ads/admanager/v1/applied_label.proto";
import "google/ads/admanager/v1/size.proto";
import "google/api/field_behavior.proto";

option csharp_namespace = "Google.Ads.AdManager.V1";
option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
option java_multiple_files = true;
option java_outer_classname = "CreativePlaceholderProto";
option java_package = "com.google.ads.admanager.v1";
option objc_class_prefix = "GAA";
option php_namespace = "Google\\Ads\\AdManager\\V1";

// Describes a slot that a creative is expected to fill. This is used in
// forecasting and to validate that the correct creatives are associated with
// the line item.
message CreativePlaceholder {
  // Required. The size that the creative is expected to have.
  Size size = 1 [(google.api.field_behavior) = REQUIRED];

  // The companions that the creative is expected to have. This attribute can
  // only be set if the line item it belongs to has an
  // [EnvironmentType][google.ads.admanager.v1.EnvironmentTypeEnum.EnvironmentType]
  // of VIDEO_PLAYER or [roadblocking_type][LineItem.roadblocking_type] of
  // CREATIVE_SET.
  repeated Size companion_sizes = 2;

  // Expected number of creatives that will be uploaded corresponding to this
  // creative placeholder.  This estimate is used to improve the accuracy of
  // forecasting; for example, if label frequency capping limits the number of
  // times a creative may be served.
  int32 expected_creative_count = 3;

  // Set of labels applied directly to this CreativePlaceholder.
  repeated AppliedLabel applied_labels = 4;

  // Indicates if the expected creative of this placeholder has an AMP only
  // variant. This is used to improve the accuracy of forecasting and has no
  // effect on serving.
  bool amp_only = 5;

  // The display name of the creative targeting that this CreativePlaceholder
  // represents.
  string creative_targeting_display_name = 6;
}
