How to manage the pin position in the ad

[san...@knorex.com]

Hi,

I see in the Ad, we can setup the pin position of Headline or Description.

How can we do it? Can you send us the documentation? with Java code samples?

I attached the screenshot.

Thanks

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

I understand that you are looking for guidance in setting the pin position for headlines and descriptions using the Google Ads API. I would recommend using the adGroupAds method and set the 'pinnedField' and select the position as per your requirement. We have tried this approach and were able to set the pin positions for both the headlines and descriptions using the Google Ads API. However, I am attaching the sample request and response logs for your reference. 

Request Body:

POST https://googleads.googleapis.com/v17/customers/{customer ID}/adGroupAds:mutate?key=[YOUR_API_KEY] HTTP/1.1

developer-token: **********************
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "operations": [
    {
      "create": {
        "ad": {
          "responsiveSearchAd": {
            "descriptions": [
              {
                "text": "dfgtrh dfegtght",
                "pinnedField": "DESCRIPTION_2"
              },
              {
                "text": "sdfwed",
                "pinnedField": "DESCRIPTION_1"
              }
            ],
            "headlines": [
              {
                "pinnedField": "HEADLINE_1",
                "text": "good one"
              },
              {
                "text": "safewv",
                "pinnedField": "HEADLINE_2"
              },
              {
                "text": "sadfewfewf",
                "pinnedField": "HEADLINE_3"
              }
            ]
          },
          "finalUrls": [
            "https://www.example.com"
          ]
        },
        "adGroup": "customers/{customer ID}/adGroups/{ad_group_ID}"
      }
    }
  ]
}

Response:

HTTP/1.1 200 
cache-control: private
content-encoding: gzip
content-length: 123
content-type: application/json; charset=UTF-8
date: Mon, 16 Sep 2024 11:35:39 GMT
server: ESF
vary: Origin, X-Origin, Referer

{
  "results": [
    {
      "resourceName": "customers/{customer ID}/adGroupAds/{ad_group_id}~{ad_ID}"
    }
  ]
}

I hope this helps. 
 

This message is in relation to case "ref:!00D1U01174p.!5004Q02vG9Fi:ref" (ADR-00268195)

Thanks,
 

Google Ads API Team