GoogleAdsGoogleadsV25Services__BookCampaignsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-book-campaigns-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__BookCampaignsRequest",
  "description": "Request message for ReservationService.BookCampaigns.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-reservations-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__BookCampaignsRequest",
  "type": "object",
  "properties": {
    "operation": {
      "description": "The operation to book the campaigns.",
      "$ref": "#/$defs/GoogleAdsGoogleadsV25Actions__BookCampaignsOperation"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Actions_BookCampaignsOperation_Campaign": {
      "type": "object",
      "properties": {
        "campaign": {
          "type": "string",
          "description": "Campaign resource to book. Format: customers/{customer_id}/campaigns/{campaign_id}"
        },
        "requestType": {
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Book the campaign. The campaign must have ENABLED status. If the campaign has a hold, it will remove the hold and confirm the contract.",
            "Hold the inventory for the campaign. The campaign must have PAUSED status to request a hold."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "BOOK",
            "HOLD"
          ],
          "type": "string",
          "description": "Determines if the current request should book the inventory or hold it."
        }
      },
      "description": "A single campaign to book."
    },
    "GoogleAdsGoogleadsV25Actions__BookCampaignsOperation": {
      "type": "object",
      "properties": {
        "campaigns": {
          "description": "Campaigns to book. Maximum 2 campaigns per request.",
          "items": {
            "$ref": "#/$defs/GoogleAdsGoogleadsV25Actions_BookCampaignsOperation_Campaign"
          },
          "type": "array"
        },
        "quoteSignature": {
          "description": "If provided, the signature of the previous quote. Clients should always provide the quote signature from previous quotes if they haven't changed the campaigns to prevent price fluctuations within a user session.",
          "type": "string"
        }
      },
      "description": "Request message for the BookCampaigns action. Request including this operation can have a latency of up to 30 seconds. This feature is not publicly available."
    }
  }
}