- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- AdGroupKeywordSuggestion
- UnusableAdGroup
- جرِّبه الآن
عرض قائمة بالمجموعات الإعلانية المقترحة والتعديلات المقترحة (النص، نوع المطابقة) للكلمات الرئيسية المحددة.
قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAdGroupThemes
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
الحقول | |
---|---|
keywords[] |
مطلوبة. قائمة بالكلمات الرئيسية المطلوب تجميعها في المجموعات الإعلانية المقدَّمة. |
adGroups[] |
مطلوبة. قائمة بأسماء موارد المجموعات الإعلانية لتجميع الكلمات الرئيسية فيها. تنسيق اسم المورد: |
نص الاستجابة
رسالة الرد لـ "KeywordPlanIdeaService.GenerateAdGroupThemes
".
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
الحقول | |
---|---|
adGroupKeywordSuggestions[] |
قائمة بإقران المجموعات الإعلانية/الكلمات الرئيسية المقترَحة |
unusableAdGroups[] |
قائمة بالمجموعات الإعلانية المقدَّمة التي تعذّر استخدامها كاقتراحات. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
AdGroupKeywordSuggestion
إقران النص المقترح والمجموعة الإعلانية/الحملة لكلمة رئيسية معينة.
تمثيل JSON |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
الحقول | |
---|---|
keywordText |
نص الكلمة الرئيسية الأصلي. |
suggestedKeywordText |
النسخة التي تمت تسويتها من نص الكلمة الرئيسية للاقتراحات الشاملة/الدقيقة/الPHRASE |
suggestedMatchType |
نوع مطابقة الكلمات الرئيسية المقترَح. |
suggestedAdGroup |
المجموعة الإعلانية المقترَحة للكلمة الرئيسية. تنسيق اسم المورد: |
suggestedCampaign |
الحملة المقترَحة للكلمة الرئيسية. تنسيق اسم المورد: |
UnusableAdGroup
زوج مجموعة إعلانية/حملة لا يمكن استخدامه كاقتراح للكلمات الرئيسية.
قد لا تكون المجموعات الإعلانية قابلة للاستخدام إذا كانت المجموعة الإعلانية
- ينتمي إلى حملة غير مفعّلة أو متوقفة مؤقتًا
- نفسه غير مفعّل
تمثيل JSON |
---|
{ "adGroup": string, "campaign": string } |
الحقول | |
---|---|
adGroup |
اسم مورد المجموعة الإعلانية. تنسيق اسم المورد: |
campaign |
اسم مورد الحملة. تنسيق اسم المورد: |