REST Resource: customers.extensionFeedItems

{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}

string

Immutable. The resource name of the extension feed item. Extension feed item resource names have the form:

customers/{customerId}/extensionFeedItems/{feed_item_id}

enum (ExtensionType)

Output only. The extension type of the extension feed item. This field is read-only.

object (AdScheduleInfo)

List of non-overlapping schedules specifying all time intervals for which the feed item may serve. There can be a maximum of 6 schedules per day.

enum (FeedItemTargetDevice)

The targeted device.

object (KeywordInfo)

The targeted keyword.

enum (FeedItemStatus)

Output only. Status of the feed item. This field is read-only.

string (int64 format)

Output only. The ID of this feed item. Read-only.

string

Start time in which this feed item is effective and can begin serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

string

End time in which this feed item is no longer effective and will stop serving. The time is in the customer's time zone. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"

string

The targeted geo target constant.

object (SitelinkFeedItem)

Sitelink extension.

object (StructuredSnippetFeedItem)

Structured snippet extension.

object (AppFeedItem)

App extension.

object (CallFeedItem)

Call extension.

object (CalloutFeedItem)

Callout extension.

object (TextMessageFeedItem)

Text message extension.

object (PriceFeedItem)

Price extension.

object (PromotionFeedItem)

Promotion extension.

object (LocationFeedItem)

Output only. Location extension. Locations are synced from a GMB account into a feed. This field is read-only.

object (AffiliateLocationFeedItem)

Output only. Affiliate location extension. Feed locations are populated by Google Ads based on a chain ID. This field is read-only.

object (HotelCalloutFeedItem)

Hotel Callout extension.

object (ImageFeedItem)

Immutable. Advertiser provided image extension.

string

The targeted campaign.

string

The targeted ad group.

{
  "values": [
    string
  ],
  "header": string
}

string

The values in the snippet. The maximum size of this collection is 10.

string

The header of the snippet. This string must not be empty.

{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}

enum (AppStore)

The application store that the target application belongs to. This field is required.

string

A list of possible final URLs after all cross domain redirects. This list must not be empty.

string

A list of possible final mobile URLs after all cross domain redirects.

object (CustomParameter)

A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.

string

The visible text displayed when the link is rendered in an ad. This string must not be empty, and the length of this string should be between 1 and 25, inclusive.

string

The store-specific ID for the target application. This string must not be empty.

string

URL template for constructing a tracking URL. Default value is "{lpurl}".

string

URL template for appending params to landing page URLs served with parallel tracking.

{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}

string

The business name to prepend to the message text. This field is required.

string

Uppercase two-letter country code of the advertiser's phone number. This field is required.

string

The advertiser's phone number the message will be sent to. Required.

string

The text to show in the ad. This field is required.

string

The message extensionText populated in the messaging app.

{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}

enum (PriceExtensionType)

Price extension type of this extension.

enum (PriceExtensionPriceQualifier)

Price qualifier for all offers of this price extension.

object (PriceOffer)

The price offerings in this price extension.

string

Tracking URL template for all offers of this price extension.

string

The code of the language used for this price extension.

string

Tracking URL template for all offers of this price extension.

{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}

object (Money)

Price value of this offer.

enum (PriceExtensionPriceUnit)

Price unit for this offer.

string

A list of possible final URLs after all cross domain redirects.

string

A list of possible final mobile URLs after all cross domain redirects.

string

Header text of this offer.

string

Description text of this offer.

{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}

enum (PromotionExtensionDiscountModifier)

Enum that modifies the qualification of the discount.

enum (PromotionExtensionOccasion)

The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion.

string

A list of possible final URLs after all cross domain redirects. This field is required.

string

A list of possible final mobile URLs after all cross domain redirects.

object (CustomParameter)

A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.

string

A freeform description of what the promotion is targeting. This field is required.

string

Start date of when the promotion is eligible to be redeemed.

string

Last date when the promotion is eligible to be redeemed.

string

URL template for constructing a tracking URL.

string

URL template for appending params to landing page URLs served with parallel tracking.

string

The language of the promotion. Represented as BCP 47 language tag.

string (int64 format)

Percentage off discount in the promotion in micros. One million is equivalent to one percent. Either this or money_off_amount is required.

object (Money)

Money amount off for discount in the promotion. Either this or percentOff is required.

string

A code the user should use in order to be eligible for the promotion.

object (Money)

The amount the total order needs to be for the user to be eligible for the promotion.

{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}

string

The name of the business.

string

Line 1 of the business address.

string

Line 2 of the business address.

string

City of the business address.

string

Province of the business address.

string

Postal code of the business address.

string

Country code of the business address.

string

Phone number of the business.

{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}

string

The name of the business.

string

Line 1 of the business address.

string

Line 2 of the business address.

string

City of the business address.

string

Province of the business address.

string

Postal code of the business address.

string

Country code of the business address.

string

Phone number of the business.

string (int64 format)

Id of the retail chain that is advertised as a seller of your product.

string

Name of chain.

{
  "text": string,
  "languageCode": string
}

string

The callout text. The length of this string should be between 1 and 25, inclusive.

string

The language of the hotel callout text. IETF BCP 47 compliant language code.

{
  "imageAsset": string
}

string

Required. Resource name of the image asset.