Method: customers.searchAds360.search

সার্চ কোয়েরির সাথে মেলে এমন সমস্ত সারি ফেরত দেয়।

প্রদর্শিত ত্রুটিগুলির তালিকা: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

HTTP অনুরোধ

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
customerId

string

প্রয়োজনীয়। যে গ্রাহকের তথ্য অনুসন্ধান করা হচ্ছে তার আইডি।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
ক্ষেত্র
query

string

আবশ্যক। কোয়েরি স্ট্রিং।

pageToken

string

যে পৃষ্ঠাটি পুনরুদ্ধার করতে হবে তার টোকেন। যদি নির্দিষ্ট না করা হয়, তাহলে ফলাফলের প্রথম পৃষ্ঠাটি ফেরত দেওয়া হবে। ফলাফলের পরবর্তী পৃষ্ঠার অনুরোধ করার জন্য পূর্ববর্তী প্রতিক্রিয়া থেকে nextPageToken এর মান ব্যবহার করুন।

pageSize

integer

একটি একক পৃষ্ঠায় পুনরুদ্ধার করার জন্য উপাদানের সংখ্যা। যখন খুব বড় একটি পৃষ্ঠার জন্য অনুরোধ করা হয়, তখন সার্ভার ফেরত দেওয়া রিসোর্সের সংখ্যা আরও সীমিত করার সিদ্ধান্ত নিতে পারে।

validateOnly

boolean

যদি সত্য হয়, তাহলে অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না।

returnTotalResultsCount

boolean

যদি true হয়, তাহলে LIMIT ক্লজটি উপেক্ষা করে কোয়েরির সাথে মিলে যাওয়া মোট ফলাফলের সংখ্যা রেসপন্সে অন্তর্ভুক্ত করা হবে। ডিফল্ট মান হলো false।

summaryRowSetting

enum ( SummaryRowSetting )

একটি সারাংশ সারি ফেরত দেওয়া হবে কিনা তা নির্ধারণ করে। ডিফল্টরূপে, সারাংশ সারি ফেরত দেওয়া হয় না। অনুরোধ করা হলে, অন্যান্য সমস্ত কোয়েরির ফলাফল ফেরত দেওয়ার পরে একটি রেসপন্সে সারাংশ সারিটি আলাদাভাবে পাঠানো হবে।

প্রতিক্রিয়া সংস্থা

SearchAds360Service.Search এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
ক্ষেত্র
results[]

object ( SearchAds360Row )

কোয়েরির সাথে মিলে যাওয়া সারিগুলোর তালিকা।

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা আনার জন্য পেজিনেশন টোকেন ব্যবহার করা হয়। পরবর্তী রিকোয়েস্টের pageToken অ্যাট্রিবিউট হিসেবে এই স্ট্রিংটির বিষয়বস্তু পাস করুন। শেষ পৃষ্ঠার জন্য nextPageToken ফেরত দেওয়া হয় না।

totalResultsCount

string ( int64 format)

LIMIT ক্লজ উপেক্ষা করে কোয়েরির সাথে মিলে যাওয়া মোট ফলাফলের সংখ্যা।

fieldMask

string ( FieldMask format)

ফিল্ডমাস্ক যা নির্দেশ করে ব্যবহারকারী কোন কোন ফিল্ডের জন্য অনুরোধ করেছেন।

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

summaryRow

object ( SearchAds360Row )

সারাংশ সারি, যেখানে ফলাফলের মেট্রিকগুলোর সারাংশ থাকে। মেট্রিকের সারাংশ বলতে সমস্ত ফলাফল জুড়ে মেট্রিকগুলোর সমষ্টিকে বোঝায়; এখানে এই সমষ্টি হতে পারে যোগফল, গড়, হার ইত্যাদি।

customColumnHeaders[]

object ( CustomColumnHeader )

ফলাফলের কাস্টম কলামগুলোর হেডারগুলো।

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

ফলাফলে থাকা রূপান্তর কাস্টম মেট্রিকগুলোর হেডার।

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

ফলাফলে থাকা রূপান্তর কাস্টম ডাইমেনশনগুলোর হেডারগুলো।

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

ফলাফলে থাকা কাঁচা ইভেন্ট রূপান্তর মেট্রিক্সের হেডারগুলো।

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

ফলাফলে থাকা কাঁচা ইভেন্ট রূপান্তর ডাইমেনশনগুলোর হেডার।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/doubleclicksearch