productstudiopb

type GenerateImageBackgroundConfig struct {

	// Required. Example: "Hat on a baseball field"
	// "Hat" = product description
	// Description of product.
	ProductDescription string `protobuf:"bytes,1,opt,name=product_description,json=productDescription,proto3" json:"product_description,omitempty"`
	// Required. Example: "Hat on a baseball field"
	// "on a baseball field" = background description
	// Description of wanted background.
	BackgroundDescription string `protobuf:"bytes,2,opt,name=background_description,json=backgroundDescription,proto3" json:"background_description,omitempty"`
	// contains filtered or unexported fields
}

type GenerateProductImageBackgroundRequest struct {

	// Required. The account for which to generate an image. This acts as a
	// container for the request and does not affect the generation itself.
	// Format: accounts/{account}
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional. Configuration for how the output image should be returned.
	OutputConfig *OutputImageConfig `protobuf:"bytes,2,opt,name=output_config,json=outputConfig,proto3" json:"output_config,omitempty"`
	// Required. The input image.
	InputImage *InputImage `protobuf:"bytes,3,opt,name=input_image,json=inputImage,proto3" json:"input_image,omitempty"`
	// Required. Configuration parameters for the generation of the background.
	Config *GenerateImageBackgroundConfig `protobuf:"bytes,4,opt,name=config,proto3" json:"config,omitempty"`
	// contains filtered or unexported fields
}

type GenerateProductImageBackgroundResponse struct {

	// The generated output image.
	GeneratedImage *GeneratedImage `protobuf:"bytes,1,opt,name=generated_image,json=generatedImage,proto3" json:"generated_image,omitempty"`
	// contains filtered or unexported fields
}

type GenerateProductTextSuggestionsRequest struct {

	// Required. The name of the account to generate text suggestions for. This
	// acts as a container for the request and does not affect the generation
	// itself, as this is a stateless API. Format: accounts/{account}
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Required. Available information about the product. Used to inform the genAI
	// models.
	ProductInfo *ProductInfo `protobuf:"bytes,2,opt,name=product_info,json=productInfo,proto3" json:"product_info,omitempty"`
	// Optional. Configuration parameters that directly influence what content is
	// generated, and how that content is rendered in the final response.
	OutputSpec *OutputSpec `protobuf:"bytes,3,opt,name=output_spec,json=outputSpec,proto3,oneof" json:"output_spec,omitempty"`
	// Optional. Provide some hand-crafted examples of title improvements that are
	// unique to your use case. This is a general tool that handles multiple
	// product categories, but your brand identity may require custom
	// functionality. Feel free to specify that here.
	TitleExamples []*TitleExample `protobuf:"bytes,4,rep,name=title_examples,json=titleExamples,proto3" json:"title_examples,omitempty"`
	// contains filtered or unexported fields
}

type GenerateProductTextSuggestionsResponse struct {

	// Generated title suggestion.
	Title *ProductTextGenerationSuggestion `protobuf:"bytes,1,opt,name=title,proto3,oneof" json:"title,omitempty"`
	// Generated description suggestion.
	Description *ProductTextGenerationSuggestion `protobuf:"bytes,2,opt,name=description,proto3,oneof" json:"description,omitempty"`
	// Any other generated attributes.
	Attributes map[string]string `` /* 161-byte string literal not displayed */
	// Additional info that clients may want to audit surrounding the generation.
	Metadata *ProductTextGenerationMetadata `protobuf:"bytes,4,opt,name=metadata,proto3,oneof" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

type GeneratedImage struct {

	// The generated image.
	//
	// Types that are assignable to Image:
	//
	//	*GeneratedImage_Uri
	//	*GeneratedImage_ImageBytes
	Image isGeneratedImage_Image `protobuf_oneof:"image"`
	// Identifier. The unique key for the image.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The timestamp when the image was generated.
	GenerationTime *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=generation_time,json=generationTime,proto3" json:"generation_time,omitempty"`
	// contains filtered or unexported fields
}

type GeneratedImage_ImageBytes struct {
	// Raw bytes for the image.
	ImageBytes []byte `protobuf:"bytes,3,opt,name=image_bytes,json=imageBytes,proto3,oneof"`
}

type GeneratedImage_Uri struct {
	// Generally web-requestable URI of the generated image. This is a temporary
	// URI and will expire after 6 months. A URI may not be populated
	// immediately after generation. Use get or list api using image_id to get
	// the URI.
	Uri string `protobuf:"bytes,2,opt,name=uri,proto3,oneof"`
}

type Image struct {

	// Required. The image to use for text generation.
	//
	// Types that are assignable to Image:
	//
	//	*Image_Uri
	//	*Image_Data
	Image isImage_Image `protobuf_oneof:"image"`
	// contains filtered or unexported fields
}

type ImageServiceClient interface {
	// GenerateProductImageBackground generates a new image where the background
	// of the original image is replaced by an AI generated scene based on
	// provided product information and a text prompt.
	GenerateProductImageBackground(ctx context.Context, in *GenerateProductImageBackgroundRequest, opts ...grpc.CallOption) (*GenerateProductImageBackgroundResponse, error)
	// RemoveProductImageBackground generates a new image where the background of
	// the original image is removed.
	RemoveProductImageBackground(ctx context.Context, in *RemoveProductImageBackgroundRequest, opts ...grpc.CallOption) (*RemoveProductImageBackgroundResponse, error)
	// UpscaleProductImage generates a new image where the resolution of the
	// original image is enhanced.
	UpscaleProductImage(ctx context.Context, in *UpscaleProductImageRequest, opts ...grpc.CallOption) (*UpscaleProductImageResponse, error)
}

type ImageServiceServer interface {
	// GenerateProductImageBackground generates a new image where the background
	// of the original image is replaced by an AI generated scene based on
	// provided product information and a text prompt.
	GenerateProductImageBackground(context.Context, *GenerateProductImageBackgroundRequest) (*GenerateProductImageBackgroundResponse, error)
	// RemoveProductImageBackground generates a new image where the background of
	// the original image is removed.
	RemoveProductImageBackground(context.Context, *RemoveProductImageBackgroundRequest) (*RemoveProductImageBackgroundResponse, error)
	// UpscaleProductImage generates a new image where the resolution of the
	// original image is enhanced.
	UpscaleProductImage(context.Context, *UpscaleProductImageRequest) (*UpscaleProductImageResponse, error)
}

type Image_Data struct {
	// Raw bytes for the image.
	Data []byte `protobuf:"bytes,2,opt,name=data,proto3,oneof"`
}

type Image_Uri struct {
	// Generally web-requestable URI.
	Uri string `protobuf:"bytes,1,opt,name=uri,proto3,oneof"`
}

type InputImage struct {

	// The input image.
	//
	// Types that are assignable to Image:
	//
	//	*InputImage_ImageUri
	//	*InputImage_ImageBytes
	Image isInputImage_Image `protobuf_oneof:"image"`
	// contains filtered or unexported fields
}

type InputImage_ImageBytes struct {
	// Raw image bytes.
	ImageBytes []byte `protobuf:"bytes,2,opt,name=image_bytes,json=imageBytes,proto3,oneof"`
}

type InputImage_ImageUri struct {
	// Public uri of the image.
	ImageUri string `protobuf:"bytes,1,opt,name=image_uri,json=imageUri,proto3,oneof"`
}

type OutputImageConfig struct {

	// Optional. If true, returns the output images as serving uris instead of
	// bytes.
	ReturnImageUri bool `protobuf:"varint,1,opt,name=return_image_uri,json=returnImageUri,proto3" json:"return_image_uri,omitempty"`
	// contains filtered or unexported fields
}

type OutputSpec struct {

	// Optional. The workflow to execute for the provided product data. Workflows
	// may populate the response's title, description, or both. Currently
	// supported workflow_ids are: "title", "description", and "tide"
	WorkflowId *string `protobuf:"bytes,1,opt,name=workflow_id,json=workflowId,proto3,oneof" json:"workflow_id,omitempty"`
	// Optional. The tone of the output generated text. Supported tones are:
	// "playful", "formal", "persuasive", and "conversational"
	Tone *string `protobuf:"bytes,2,opt,name=tone,proto3,oneof" json:"tone,omitempty"`
	// Optional. Any editorial changes for the generated product data. For
	// example, replace Small with "S", do not modify color if already present.
	EditorialChanges *string `protobuf:"bytes,3,opt,name=editorial_changes,json=editorialChanges,proto3,oneof" json:"editorial_changes,omitempty"`
	// Optional. The language for output titles/descriptions. For example.
	// 'German', 'es', 'FR'. Default is 'en'.
	TargetLanguage *string `protobuf:"bytes,4,opt,name=target_language,json=targetLanguage,proto3,oneof" json:"target_language,omitempty"`
	// Optional. The order that generated attributes should be placed in the
	// generated title. Eg., if the attribute order is ["brand", "product",
	// "size"], the generated title will have brand first, followed by the product
	// name, and then size information after that.
	AttributeOrder []string `protobuf:"bytes,5,rep,name=attribute_order,json=attributeOrder,proto3" json:"attribute_order,omitempty"`
	// Optional. Character used to separate attributes in the generated title.
	// For example, '|', '-', ','.
	AttributeSeparator *string `protobuf:"bytes,6,opt,name=attribute_separator,json=attributeSeparator,proto3,oneof" json:"attribute_separator,omitempty"`
	// contains filtered or unexported fields
}

type ProductInfo struct {

	// Required. A mapping of all available product attributes. This may include
	// title, description, brand, gender, color, size, etc.
	ProductAttributes map[string]string `` /* 200-byte string literal not displayed */
	// Optional. Image associated with the product.
	ProductImage *Image `protobuf:"bytes,2,opt,name=product_image,json=productImage,proto3,oneof" json:"product_image,omitempty"`
	// contains filtered or unexported fields
}

type ProductTextGenerationMetadata struct {

	// Metadata is a pretty loose concept. The data is modeled as a map here to
	// indicate that there is no guaranteed structure to the output past a simple
	// K:V association.
	// The first use-case is to track words added/removed/changed in generations.
	Metadata *structpb.Struct `protobuf:"bytes,1,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

type ProductTextGenerationSuggestion struct {

	// The text generated
	Text *string `protobuf:"bytes,1,opt,name=text,proto3,oneof" json:"text,omitempty"`
	// The quality score associated with the generation. Heuristic implemented
	// according to the feedgen team's implementation styles.
	Score *float32 `protobuf:"fixed32,2,opt,name=score,proto3,oneof" json:"score,omitempty"`
	// A brief summarization of all the changes that have been made.
	ChangeSummary *string `protobuf:"bytes,3,opt,name=change_summary,json=changeSummary,proto3,oneof" json:"change_summary,omitempty"`
	// contains filtered or unexported fields
}

type RemoveImageBackgroundConfig struct {

	// Optional. If set, the result of background removal will be an RGB image
	// with this given color as the background, instead of an RGBA 4-channel
	// transparent image.
	BackgroundColor *RgbColor `protobuf:"bytes,1,opt,name=background_color,json=backgroundColor,proto3" json:"background_color,omitempty"`
	// contains filtered or unexported fields
}

type RemoveProductImageBackgroundRequest struct {

	// Required. The account for which to generate an image. This acts as a
	// container for the request and does not affect the generation itself.
	// Format: accounts/{account}
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional. Configuration for how the output image should be returned.
	OutputConfig *OutputImageConfig `protobuf:"bytes,2,opt,name=output_config,json=outputConfig,proto3" json:"output_config,omitempty"`
	// Required. The input image.
	InputImage *InputImage `protobuf:"bytes,3,opt,name=input_image,json=inputImage,proto3" json:"input_image,omitempty"`
	// Optional. Configuration parameters for the removal of the background.
	Config *RemoveImageBackgroundConfig `protobuf:"bytes,4,opt,name=config,proto3" json:"config,omitempty"`
	// contains filtered or unexported fields
}

type RemoveProductImageBackgroundResponse struct {

	// The generated output image.
	GeneratedImage *GeneratedImage `protobuf:"bytes,1,opt,name=generated_image,json=generatedImage,proto3" json:"generated_image,omitempty"`
	// contains filtered or unexported fields
}

type RgbColor struct {

	// Optional. Values in [0, 255].
	Red int32 `protobuf:"varint,1,opt,name=red,proto3" json:"red,omitempty"`
	// Optional. Values in [0, 255].
	Green int32 `protobuf:"varint,2,opt,name=green,proto3" json:"green,omitempty"`
	// Optional. Values in [0, 255].
	Blue int32 `protobuf:"varint,3,opt,name=blue,proto3" json:"blue,omitempty"`
	// contains filtered or unexported fields
}

type TextSuggestionsServiceClient interface {
	// GenerateProductTextSuggestions generates a set of candidate text
	// completions (e.g., product titles, descriptions) based on provided product
	// information. This endpoint leverages GenAI models to create suggestions for
	// improving existing product text or generating new content.
	GenerateProductTextSuggestions(ctx context.Context, in *GenerateProductTextSuggestionsRequest, opts ...grpc.CallOption) (*GenerateProductTextSuggestionsResponse, error)
}

type TextSuggestionsServiceServer interface {
	// GenerateProductTextSuggestions generates a set of candidate text
	// completions (e.g., product titles, descriptions) based on provided product
	// information. This endpoint leverages GenAI models to create suggestions for
	// improving existing product text or generating new content.
	GenerateProductTextSuggestions(context.Context, *GenerateProductTextSuggestionsRequest) (*GenerateProductTextSuggestionsResponse, error)
}

type TitleExample struct {

	// Required. A map containing all existing product information. For example:
	// {"title": "dress", "description": "A red dress", "brand": "Dresses4All"}
	// Any information that you might use to populate your product feed.
	ProductInfo map[string]string `` /* 182-byte string literal not displayed */
	// Required. The product's category. This helps the AI understand when certain
	// examples are more relevant than others.
	Category *string `protobuf:"bytes,2,opt,name=category,proto3,oneof" json:"category,omitempty"`
	// Required. The attributes or approximate attributes that make up the title.
	// For example, title "Google GShoe M" title_format can be "brand | product |
	// size".
	TitleFormat *string `protobuf:"bytes,3,opt,name=title_format,json=titleFormat,proto3,oneof" json:"title_format,omitempty"`
	// Required. A map in the same format as product_info but with all
	// improvements included. For example, {"brand": "Dresses4All", "product":
	// "dress", "color": "red", ...}. The order of attributes in this map may be
	// used to guide the order in which they appear in the final generated title.
	// For instance, the above will become: Dresses4All dress | red
	FinalProductInfo map[string]string `` /* 199-byte string literal not displayed */
	// contains filtered or unexported fields
}

type UnimplementedImageServiceServer struct {
}

type UnimplementedTextSuggestionsServiceServer struct {
}

type UpscaleProductImageRequest struct {

	// Required. The account for which to generate an image. This acts as a
	// container for the request and does not affect the generation itself.
	// Format: accounts/{account}
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional. Configuration for how the output image should be returned.
	OutputConfig *OutputImageConfig `protobuf:"bytes,2,opt,name=output_config,json=outputConfig,proto3" json:"output_config,omitempty"`
	// Required. The input image.
	InputImage *InputImage `protobuf:"bytes,3,opt,name=input_image,json=inputImage,proto3" json:"input_image,omitempty"`
	// contains filtered or unexported fields
}

type UpscaleProductImageResponse struct {

	// The generated output image.
	GeneratedImage *GeneratedImage `protobuf:"bytes,1,opt,name=generated_image,json=generatedImage,proto3" json:"generated_image,omitempty"`
	// contains filtered or unexported fields
}